Hi all

First of all, I love the increasing activity on the list. Apache Weex slowly learns the Apache Way. Continue like this!

I think you sorted out really good points. Documentation is an important topic and we have to do better there. If Developers don't find the way into the project, they often leave the project without making a beep.

We can use GitHub issues as well as GitHub Pull Request comments. But we have to forward them to the Mailing lists. (commits@ would probably be the right one). I can ask infra to do that, no problem. What we should not do is to use both. This is very confusing for new devs, and you probably miss informations.

It's up to the community to decide, if we want to use jira of github. From Apache perspective both ar fine.

Regards Raphael

Am .10.2017, 08:30 Uhr, schrieb Hanks Zhang <[email protected]>:

Cheers!

According to my observation, our documents and tools are often questioned
in the community. If we do improve that, developers can use weex more
easily and it can also inspire the community.

I'm reorganizing the structure of our documents and website. Considering
that our developers are various (could be Android, iOS, Front-End
developers), we should make the documents easier to understand even they
don't have the elementary knowledge of particular platforms. I think
everyone needs to work together to achieve this goal.

By the way, eggjs/egg is an awesome project. But as weex is using JIRA [1]
to manage issues, not GitHub, and it's combined our workflow. I think
asking questions on StackOverflow is a more proper way than on issues.

[1] https://issues.apache.org/jira/projects/WEEX

----

Hanks

2017-10-13 13:06 GMT+08:00 NetPuter <[email protected]>:

I think another project from alibaba is a great example: eggjs/egg
<https://github.com/eggjs/egg>. There are many things can learn from it.
Such as make github issues as stackoverflow, RFC before doing, etc..

2017-10-13 12:17 GMT+08:00 Adam Feng <[email protected]>:

> Hi, all:
> I think it's important to have a roadmap to change the present situation > in community and diversity. I have written a proposal for the follow-on
> community building. Please have a review and any advice is welcome:D.
> The first stage should be "DO BETTER", improving the workflow,
> documentation, tools, plugins, etc. which are the largest short boards
for
> now.
>
> 1. Workflow:
>
>     • Discussion, all the things below should be discussed on dev@ or
> Jira issues, discuss BEFORE commit.
>
>         • work in-progress
>         • feature to be implemented
>         • any ideas, either for feature or for community
>
>     • Contribution
>
>         • make a clearer contribution guide, including how to create
> issues(with a good format), ask or answer questions, join discussions,
> contribute to documentation, contribute to code, etc.
>         • add easy-to-solve tags or labels to some issues to attract
> contribution.
>
>     • Development
>
>         • change branch flow which was mentioned in [1] .
>         • define a good commit format, as the commits now are really
messy
>         • one commit for one issue
>
>
> 2. Documentation
>
>     • a complete 0-1 tutorial is badly needed
> • modify documentation style and structure which is in progress [2] > • encourage EVERYONE to rewrite the documents which are difficult to
> understand and find some native speakers to have a review.
>     • add a document evaluation mechanism to indicate the quality of
> documentation.
>     • add a who-is-using-weex page in a obvious place.
>
> 3. Plugins
>
> • develop more plugins with interaction ability to community, such as
> rich-text, gesture, animation, etc.
>     • create tools to link plugins more easily.
>
> 4. Tools
>
>     • improve weex toolkit and devtool's developer experience, get all
the
> commands in order, make sure every command has clear flow and error
> handling.
>
>
> If the community has enough "content", the next stage should be "PROMOTE > OURSELVES", we should try to make connection with developers from Europe
> and America, we can promote our community with the help of Vuejs
community.
>
> 1. Writing Blogs, the first blog can be a complete tutorial about Weex, > followed by some blogs about technical details, one blog each week will
be
> excellent at the beginning.
> 2. Use Western Social Media like Twitter, Facebook, etc.
> 3. Other channels like newsletter, meetup, AMA, etc.
>
> If there are no objections, I will create issue for every action and try
> to find appropriate guy to accomplish it. The community building needs
> EVERYONE's help!
> [1] https://issues.apache.org/jira/browse/WEEX-75
> [2] https://issues.apache.org/jira/browse/WEEX-79
>
> Thanks.
> Adam Feng
>



--
Best Regards,
NetPuter Lin *»* <http://netputer.me/>



--
My introduction https://youtu.be/Ln4vly5sxYU

Reply via email to