Hello Sergii,
To the question whether the documentation is useful: IMO Yes, I 100% think it is useful. I did a quick read through the links.
Where to put it, this is an interesting question.
The advantage of Documentation/ directory in the repository is that it allows other people (anyone who is interested) to review the text before adding. Because for Documentation/ you basically send a patch and everyone can review. End result gets submitted, and everyone is happy.
For the website, there is no review mechanism, so you either update the page and announce it to everyone, and then people can make corrections post-update. Another way is, after preparing the text you send it to the mailing list and gather feedback, and then later incorporate feedback into the final version of text. This is a more awkward process. But as you said, these docs are for users not developers - so the website seems like a more logical place. I looked through the website, this section seems relevant: https://www.flashrom.org/Documentation#Using_flashrom ?
For the website also, we do have ideas to dramatically upgrade it, but in any case all the content will be migrated over.
I am wondering what other people think, especially if anyone has strong opinions on Documentation/ vs wiki?
On Sat, Oct 8, 2022 at 8:41 AM Sergii Dmytruk sergii.dmytruk@3mdeb.com wrote:
Hi there,
We have a bit of user documentation that shows how to lock a bootblock using WP [1] and what should be taken into account before you do it [2] and thought we can offer it to the upstream (after a bit of editing if there is interest).
There is Documentation/ directory in the repository, but I guess Wiki on www.flashrom.org might be more appropriate as it's not documentation for developers. The current format is Markdown, but `pandoc` can convert the files to MediaWiki without issues.
Please check out the docs and say if they can be useful for the project.
Cheers, Sergii _______________________________________________ flashrom mailing list -- flashrom@flashrom.org To unsubscribe send an email to flashrom-leave@flashrom.org