-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256
On 14/06/18 19:01, Martin Roth wrote:
- When the wiki was started, we didn't really think about
licensing, so most of what's been written needs to be scrapped as we're not going to go back and contact all of the original authors, many of whom are no longer part of the project, to see if it's OK to update the license on their contribution. As we've joined the SFC and committed to having all of our documentation correctly licensed with an appropriate license, this means that we'd be starting over, regardless of whether we stuck with a wiki or changed to something else.
This is also by virtue of the way MediaWiki is designed.
- The wiki requires a separate login from everything else, which
has to be created manually. We've gotten criticism for only allowing wiki access to "a few coreboot elites". People can sign up for a gerrit account and contribute to the coreboot documentation with pretty minimal restrictions.
Not only that, but it wasn't clear how to get an account in the first place.
By the way, what do you think of the idea I floated in a previous message? My idea is to have some kind of web interface where a non-technical user who doesn't know how to use git can browse the documentation on the website and click "edit", which will take them to the appropriate markdown file in the repository. When they're done, they give their edit a title and description, which becomes the commit message, and their contribution gets sent to code review (Gerrit).
How feasible do you think this would be? It would give some of the ease of use of MediaWiki as before, while still having all of the advantages that you listed.
On Thu, Jun 14, 2018 at 12:35 PM Leah Rowe info@gluglug.org.uk wrote:
On 14/06/18 19:01, Martin Roth wrote:
- The wiki requires a separate login from everything else, which
has to be created manually.
Not only that, but it wasn't clear how to get an account in the first place.
I guess I didn't realize that it was a problem. If you clicked 'log in' in the top of the wiki, it told you who to email along with their addresses. "If you don't have an account and wish to contribute contact Stefan Reinauer or Patrick Georgi and tell them what exactly you want to contribute." https://web.archive.org/web/20151031111952/http://www.coreboot.org:80/index....
By the way, what do you think of the idea I floated in a previous message? My idea is to have some kind of web interface where a non-technical user who doesn't know how to use git can browse the documentation on the website and click "edit", which will take them to the appropriate markdown file in the repository. When they're done, they give their edit a title and description, which becomes the commit message, and their contribution gets sent to code review (Gerrit).
How feasible do you think this would be? It would give some of the ease of use of MediaWiki as before, while still having all of the advantages that you listed.
I have no issue with that if someone wanted to work on it. It might still cause some difficulties because those people probably wouldn't be able to respond to requests for updates in gerrit, and they wouldn't necessarily follow the rest of the rules we have for submitting to coreboot, but maybe those issues could be worked out. Maybe a documentation administrator could shepherd the patches the rest of the way through the process.
As far as feasibility, I'm sure it could be done, it would just take someone committed to making it happen.
Martin
-
Leah Rowe -
Martin Roth