mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-07-16 00:44:22 +00:00
2261fd4b84
It was getting a pain to manage the content in separate places, and I suspect confusing for end users. I think the best time to move the dev content out is when we’ve established the community wiki for TW5, which is a much more natural home for it. In the meantime, a feature that I’m interested in exploring is the ability to hide tiddlers from the UI based on tag. Then the tw5.com wiki could disable all tiddlers tagged ‘dev’ until explicitly overridden by the user.
58 lines
2.4 KiB
Plaintext
58 lines
2.4 KiB
Plaintext
created: 201311011114
|
|
creator: JeremyRuston
|
|
modified: 201311011114
|
|
modifier: JeremyRuston
|
|
tags: introduction
|
|
title: Contributing
|
|
|
|
TiddlyWiki5 welcomes contributions to its code and documentation via [[GitHub|https://github.com/Jermolene/TiddlyWiki5]]. Please take a moment to read these notes to help make the process as smooth as possible.
|
|
|
|
!! Bug Reports
|
|
|
|
From the perspective of the developers, a bug report that says little more than "it doesn't work" can be frustrating. For effective debugging, we need as much information as possible. At a minimum, please try to include:
|
|
|
|
* A descriptive title
|
|
* A summary
|
|
* Steps to reproduce
|
|
* Expected behaviour
|
|
* Context (OS, browser etc.)
|
|
|
|
There's a lot of good material on the web about bug reports:
|
|
|
|
* http://mhay68.tumblr.com/post/1648223018/what-makes-a-good-bug-report
|
|
* http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
|
|
|
|
!! Pull Requests
|
|
|
|
Like other OpenSource projects, TiddlyWiki5 needs a signed contributor license agreement from individual contributors before contributions of code can be accepted. This is a legal agreement that allows contributors to assert that they own the copyright of their contribution, and that they agree to license it to the UnaMesa Association (the legal entity that owns TiddlyWiki on behalf of the community).
|
|
|
|
* For individuals use: [[CLA-individual|https://github.com/Jermolene/TiddlyWiki5/tree/master/licenses/cla-individual.md]]
|
|
* For entities use: [[CLA-entity|https://github.com/Jermolene/TiddlyWiki5/tree/master/licenses/cla-entity.md]]
|
|
|
|
//This is a first pass at a CLA for TiddlyWiki. Please let us know if we missed something important. If we do have to make essential changes to the CLA, there is a possibility that all contributors will need to sign it again//
|
|
|
|
!!! How to sign the CLA
|
|
|
|
```
|
|
git clone https://github.com/Jermolene/TiddlyWiki5.git TiddlyWiki5
|
|
cd TiddlyWiki5
|
|
git checkout -b sign-cla
|
|
```
|
|
|
|
''Add your name and the date to cla-individual.md or cla-entity.md''. Date format (YYYY/MM/DD)
|
|
eg: `Jeremy Ruston, @Jermolene, 2011/11/22`
|
|
|
|
```
|
|
git add .
|
|
git commit -m "sign contributor license agreement"
|
|
git push origin sign-cla
|
|
```
|
|
|
|
''Go to your github repo and create a pull request.''
|
|
|
|
''Thank you!''
|
|
|
|
!!!! Attribution
|
|
|
|
The CLA documents used for this project where created using [[Harmony Project Templates|http://www.harmonyagreements.org]]. "~HA-CLA-I-LIST Version 1.0" for "CLA-individual" and "~HA-CLA-E-LIST Version 1.0" for "CLA-entity"
|