Looks like we can use the `.asf.yml` file in our repositories to enable
`issues` and `wiki` behavior ourselves if we decide we like the feature :)

On Fri, Apr 24, 2020 at 7:46 AM Dave Barnes <dav...@vmware.com> wrote:

> +1
> I like the look of the samples.
> I also want to echo Anthony and Blake: Accessibility is huge, not only
> because it smooths the way for adding content, but for pruning outdated
> material.
>
> On 4/24/20, 7:18 AM, "Blake Bender" <bben...@pivotal.io> wrote:
>
>     +1 - Wow, research - nice work, Naba, this is great!
>
>     Just want to emphasize a larger point I failed to make in my response
> re:
>     Markdown.  My experience with Wikis has been that it's very difficult
> to
>     convince people to contribute entries/edits, and an active community of
>     contributors makes a big difference between a good and less-good Wiki.
>     Better content on the Wiki naturally leads to more people reading, so
>     anything we can do to eliminate barriers to entry for contributing to
> our
>     wiki is a good thing.  Having the wiki right there on GitHub removes a
> big
>     impediment, we should def do this.
>
>     Thanks,
>
>     Blake
>
>
>     On Thu, Apr 23, 2020 at 8:14 PM Nabarun Nag <n...@pivotal.io> wrote:
>
>     > Hi Anthony!
>     >
>     > Sorry for the late reply but I was doing some research. The issues
> and wiki
>     > section as of now has been used by few engineers only and Confluent
> has not
>     > yet entered any issues as they are still reviewing the project. I
> went
>     > ahead and looked into all projects in the Apache domain using issues
> and
>     > the extra features they enable.
>     > *JIRA vs Issues:*
>     >
>     >    - There are a sizable number of Apache projects who are using
> GitHub
>     >    issues
>     >    - One clear advantage is the automatic linking of PRs and Issues.
> Issues
>     >    can be closed automatically once the PR is merged.
>     >    - It can also enable a feature to delete the feature branch
>     >    automatically once the PRs is merged (we have lot unused
>     > feature/GEODE-xxxx
>     >    branches in origin which were not deleted after merging PRs)
>     >    - It enables us to use Github Project management(Github version of
>     >    PivotalTracker)  which is integrated with Github issues and PRs
> and all
>     > the
>     >    movement from "To-do", "In-progress", "resolved" and "closed" are
>     > automated
>     >    depending on if a PR is opened, requires reviews, reviewed and
> merged
>     > state.
>     >
>     > *Github Wiki vs Confluence Wiki:*
>     >
>     >    - As you have mentioned that visibility is more important, we can
> follow
>     >    other open-source products like Greenplum, Hystrix and we can use
> the
>     > wiki
>     >    page to explain stuff like how to contribute, basic architecture,
>     > internal
>     >    knowledge, i.e information that is needed to contribute to Geode.
>     >    - A signification advantage is the colocation of code and wiki.
> Any
>     >    developer can find Geode GitHub repo and that person now has all
> the
>     > tools
>     >    needed to start contributing.
>     >
>     >
>     > A few examples of well-written wikis on GitHub:
>     >
>     >    -
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fd3%2Fd3%2Fwiki&amp;data=02%7C01%7Cdaveba%40vmware.com%7Cb17baa964f014fcecc5108d7e85a6b55%7Cb39138ca3cee4b4aa4d6cd83d9dd62f0%7C0%7C0%7C637233347359128192&amp;sdata=Yq%2Bi%2FuU2%2B5JiQ1jd%2BasQ0%2F%2BTPrK4vdxm%2FK6Faw4UW3M%3D&amp;reserved=0
>     >    -
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FNetflix%2FHystrix%2Fwiki&amp;data=02%7C01%7Cdaveba%40vmware.com%7Cb17baa964f014fcecc5108d7e85a6b55%7Cb39138ca3cee4b4aa4d6cd83d9dd62f0%7C0%7C0%7C637233347359128192&amp;sdata=1c5DQgA%2BWzGFZW5v%2FJdJeeyyELsNyWuFD3JNC2C5VhI%3D&amp;reserved=0
>     >    -
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fapache%2Fhelix%2Fwiki&amp;data=02%7C01%7Cdaveba%40vmware.com%7Cb17baa964f014fcecc5108d7e85a6b55%7Cb39138ca3cee4b4aa4d6cd83d9dd62f0%7C0%7C0%7C637233347359128192&amp;sdata=89fieZFbngwXwD2uXCkEg0PTWtw1nbtU2xVn%2BpPm%2FFU%3D&amp;reserved=0
>     >
>     >
>     > ASF: word on the street is that it was mentioned in ApacheCon, that
> they
>     > support the use of Github wiki and issues in ASF projects, and this
> can
>     > also be seen in multiple INFRA tickets mentioning enabling wiki.
>     >
>     > I am also looking into ZenHub to improve our workflow. ZenHub is a
> very
>     > robust project management tools used by Apache Contributors and
>     > corporations like VMware.
>     >
>     > Regards
>     > Nabarun Nag
>     >
>     >
>     > On Thu, Apr 23, 2020 at 2:40 PM Anthony Baker <aba...@pivotal.io>
> wrote:
>     >
>     > > Having used pretty every style of wiki, I care less about the wiki
> tech
>     > > and more about making the content easily accessible and
> discoverable for
>     > > our users and contributors.  Our current wiki has a lot of useful
>     > > information.  I’d like to understand how we want to use
> repo-specific
>     > > wiki’s to augment or replace our current project wiki (or neither)\
>     > before
>     > > taking any decisions.
>     > >
>     > > Anthony
>     > >
>     > >
>     > > > On Apr 23, 2020, at 12:54 PM, Blake Bender <bben...@pivotal.io>
> wrote:
>     > > >
>     > > > GitHub Wiki supports Markdown, our current one does not.  This
> means
>     > > GitHub
>     > > > wins by default in my book.
>     > > >
>     > > > Thanks,
>     > > >
>     > > > Blake
>     > > >
>     > > >
>     > > > On Thu, Apr 23, 2020 at 8:50 AM Anthony Baker <aba...@pivotal.io
> >
>     > wrote:
>     > > >
>     > > >> Naba, do you have any updates to share?  I’m curious if you
> have found
>     > > >> this useful compared to JIRA.
>     > > >>
>     > > >> Also, I noticed that geode-kafka-connector also has a GitHub
> wiki.
>     > How
>     > > >> does that compare with centralizing our information in the ASF
>     > > confluence
>     > > >> wiki?
>     > > >>
>     > > >> Thanks,
>     > > >> Anthony
>     > > >>
>     > > >>
>     > > >>> On Mar 21, 2020, at 5:16 PM, Nabarun Nag <n...@apache.org>
> wrote:
>     > > >>>
>     > > >>> Hello team,
>     > > >>>
>     > > >>> We are planning to experiment with using Github issues and
> wiki for
>     > the
>     > > >>> Apache project *Geode-Kafka-Connector. *(not Apache Geode
> project).
>     > > >> Please
>     > > >>> do give your vote on this as we need to send the vote link to
> infra
>     > to
>     > > >>> activate it.
>     > > >>>
>     > > >>> *Why are we doing this ? / Advantages* :
>     > > >>> 1. *Unified location* to have documentation, code and issue
> tracking.
>     > > >>> 2. Leverage Github tools like Github pages to create websites
> hosting
>     > > >>> information about the project.
>     > > >>> 3. No separate JIRA accounts or permission required to create
> issues.
>     > > >>> 4. This will have *no impact on the broader Geode community*
> as right
>     > > now
>     > > >>> only 3-4 developers involved in this project.
>     > > >>> 5. *This is an experiment.* If things do not work out we can
> always
>     > > >> revert
>     > > >>> back to the traditional way of having separate JIRA,
> documentation,
>     > > >>> websites etc.
>     > > >>>
>     > > >>> *Precedence*:
>     > > >>> 1. Kubernetes uses the github issues
>     > > >>> 2. RabbitMQ uses github issues.
>     > > >>>
>     > > >>>
>     > > >>> *NOTE: *- Please be cordial and do not use any condescending
> language
>     > > and
>     > > >>> absolutely no bullying.
>     > > >>> - Please treat this email as a professional business email and
>     > maintain
>     > > >>> email etiquette while replying.
>     > > >>>
>     > > >>> Regards
>     > > >>> Nabarun
>     > > >>
>     > > >>
>     > >
>     > >
>     >
>
>

Reply via email to