I agree with this change.
As a semi-regular peruser of github projects, I would never think to
browse a separate repo for issues relating to a particular app.
I've seen projects with new issues that are pre-populated with text, which
I've seen to suggest issue structure (summary, steps to reproduce, expected
behavior, etc). One could imagine a note about contributing to a different
URL or to the contributing guidelines. This still wouldn't be especially
natural in my opinion, however.
For changes that do matter across components, a components project sibling
to collect and friends could have an issue tracker that supports
discussion. "Consider migration to component-foo 1.3" or something could be
opened on the Collect Issue tracker with a link back to the general
discussion, so users of only a single app would still be aware of the
discussion.
In general, though, I wholeheartedly agree with Brent. If commits across
repos have to be highly coordinated, things are likely too brittle. If
necessary, however, and if the continuous integration idea
https://groups.google.com/forum/#!topic/opendatakit-developers/raj3OVlc9aA
becomes a reality, it might be possible to point at particular versions of
an artifact and reduce the need for coordinated releases.
On Tue, Aug 23, 2016 at 7:41 AM, Brent Atkinson brent.atkinson@gmail.com wrote:
Hello Yaw,
I believe this loosely relates to the question I asked recently about
pull requests: https://groups.google.com/d/to
pic/opendatakit-developers/6i6i1PShYJs/discussion.
TL;DR - Yes, splitting the issues out probably will make issue management
simpler and more intuitive for those not already familiar with the existing
scheme.
Since I have not been working with the system myself, I can't pretend to
know all of the ramifications of such a move. However, I can say that the
way that issues are managed does make it somewhat more opaque than the
average GitHub project. What you suggest is more intuitive and aligns with
the tooling (and conventions) naturally. The existing system could work
with more documentation and organizational discipline, but in my opinion it
highlights the reason it is less than ideal: it needs more explanation and
discipline to make sense.
Splitting the issues out has its own trade-offs, probably the biggest one
being coordinating issues/release milestones between projects. However,
from what I understand about the design of Collect, Aggregate and friends,
they are stand-alone applications that should make sense on their own.
Having to align on project releases is probably an indication that things
are too brittle. Instead, these dependencies should be explicit in a
protocol version or equivalent, and both should depend on the protocol
version not on each other. When there are related issues, it often is
helpful to voice them in terms of the project as well - so creating a
Collect issue and referencing a related issues in Aggregate makes sense.
You'll ultimately have to make changes in both projects, having two issues
actually mirrors the work needing to be done.
With what I understand about the design of the suite, I think this makes
more sense. It also is what most GitHub users would expect to see.
Brent
On Tuesday, August 23, 2016 at 7:57:00 AM UTC-4, Yaw Anokwa wrote:
Hi all,
Given the changes coming down the line for the project, I'd like to
make things easier for contributors by moving the issues from the
project wide repo (https://github.com/opendatakit/opendatakit) to the
Collect repo (https://github.com/opendatakit/collect).
I think the current issues structure is a remnant of the move from
Google Code and it makes it unnecessarily complicated for people who
just care about Collect to track what needs fixing and update issues
when they are fixed.
Per the (brand-new!) governance guidelines at
https://github.com/opendatakit/governance/blob/master/GOVERN
ANCE.md#decision-making-process,
what does everyone think? Should we move the issues?
Yaw
--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.