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.dmyt...@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).
>
> [1]: 
> https://github.com/Dasharo/flashrom/blob/wp_integration/Documentation/heads-and-wp.md#risks-of-partial-updates
> [2]: 
> https://github.com/Dasharo/flashrom/blob/wp_integration/Documentation/bootblock-protection.md
>
> 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-le...@flashrom.org



-- 
Anastasia.
_______________________________________________
flashrom mailing list -- flashrom@flashrom.org
To unsubscribe send an email to flashrom-le...@flashrom.org

Reply via email to