MicroPython project is steadily growing, with more and more people contributing to its developments in various areas. To foster this activity and make both contributors' and maintainers' effort easier, while preserving overall direction and distinctive features of the project, there're now Contributor Guidelines available at https://github.com/micropython/micropyt ... Guidelines .
All people interested in contributing to MicroPython are welcome and encouraged to review the guidelines.
The guidelines are work in progress and subject for community discussion. Please feel free to share you comments and suggestion here, or in the ticket: https://github.com/micropython/micropython/issues/1007
Contributor Guidelines
Contributor Guidelines
Awesome MicroPython list
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
Re: Contributor Guidelines
Link to the guidelines is now shown to everyone submitting new issues or pull request, e.g.: https://github.com/micropython/micropython/issues/new
Awesome MicroPython list
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
- pythoncoder
- Posts: 5956
- Joined: Fri Jul 18, 2014 8:01 am
- Location: UK
- Contact:
Re: Contributor Guidelines
@pfalcon Shouldn't the link in your above message be https://github.com/micropython/micropyt ... IBUTING.md?
Peter Hinch
Index to my micropython libraries.
Index to my micropython libraries.
- pythoncoder
- Posts: 5956
- Joined: Fri Jul 18, 2014 8:01 am
- Location: UK
- Contact:
Re: Contributor Guidelines
A general comment on the guidelines: should there be a reference to this document https://github.com/micropython/micropyt ... elWorkflow?
A factor to bear in mind is the target audience. Clearly the guidelines are written for experienced programmers, who can be assumed to be able to follow fairly terse instructions and to access links. But some may be unfamiliar with contributing to open source projects and with Git and Github. The learning curve for Git, even for those who've used other VCS's, is steep and some pointers to external tutorials might be helpful. I'm finding https://progit.org/ useful but you guys may have other, better, suggestions.
A factor to bear in mind is the target audience. Clearly the guidelines are written for experienced programmers, who can be assumed to be able to follow fairly terse instructions and to access links. But some may be unfamiliar with contributing to open source projects and with Git and Github. The learning curve for Git, even for those who've used other VCS's, is steep and some pointers to external tutorials might be helpful. I'm finding https://progit.org/ useful but you guys may have other, better, suggestions.
Peter Hinch
Index to my micropython libraries.
Index to my micropython libraries.
Re: Contributor Guidelines
Well, I wanted to show people how submitting a new ticket shows them a hard-to-miss (hopefully? ) yellow box which links to the guidelines.pythoncoder wrote:@pfalcon Shouldn't the link in your above message be https://github.com/micropython/micropyt ... IBUTING.md?
Awesome MicroPython list
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
Re: Contributor Guidelines
That's exactly the reason why DevelWorkflow isn't "PRed" much - I know that stuff too well, so just dumped my mind to give hints to people how they can have better workflow (than have random stuff included in their pull requests or have back-and-forth changes). It's expected that people would do some googling, then hopefully someone brave will add more links to that page (or suggest better written page right away - there gotta be such).pythoncoder wrote:A general comment on the guidelines: should there be a reference to this document https://github.com/micropython/micropyt ... elWorkflow?
A factor to bear in mind is the target audience. Clearly the guidelines are written for experienced programmers, who can be assumed to be able to follow fairly terse instructions and to access links.
The general idea behind specifically ContributorGuidelines is to minimize probability that someone wants to contribute, spends time to develop code, submits it and gets a reply "sorry, we don't need it/you did it wrong". I know such situation sucks - I don't contribute to some useful/important projects because my initial attempts led to such situation. So, I'd like to do everything possible to avoid such situation, while still make sure that we don't deteriorate the project into yet another scopeless monster like some open-source projects are.But some may be unfamiliar with contributing to open source projects and with Git and Github. The learning curve for Git, even for those who've used other VCS's, is steep and some pointers to external tutorials might be helpful. I'm finding https://progit.org/ useful but you guys may have other, better, suggestions.
The guidelines do need improvements, that's why this topic was opened and why the wiki page was linked just from this topic for quite a while, to let everyone express concerns/propose improvements. With more people contributing, it's important to make it more visible, but elaboration process is continuous, and all comments are welcome (and actual improvements too).
Awesome MicroPython list
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/
Pycopy - A better MicroPython https://github.com/pfalcon/micropython
MicroPython standard library for all ports and forks - https://github.com/pfalcon/micropython-lib
More up to date docs - http://pycopy.readthedocs.io/