[coreboot] How to reduce formal issues with new contributions from corporations?

Zaolin zaolin at das-labor.org
Tue Feb 28 02:06:36 CET 2017


I guess you misunderstood something. The new documentation system
consists of the markdown documentation in the source

code repository and an automatic generated homepage via static site
generator https://gohugo.io/ .

The homepage will be updated everyday from the Documentation directory
markdown files.

It's also possible to use asciidoc or restructured Text for the
documentation.


Regards Zaolin


On 02/28/2017 01:53 AM, Taiidan at gmx.com wrote:
> On 02/27/2017 04:37 PM, Stefan Reinauer wrote:
>
>>> Should this documentation be moved to the repository? A lot of the
>>> “guideline Wiki pages” are locked anyway. People knowing the Linux
>>> kernel, would expect that to also live in the source code repository?
>> Yes, I am in favor of moving relevant documentation into the source
>> tree, as I believe that we should obsolete the wiki all together.
>>
>> Stefan
> Removing the wiki increases the learning curve for new users and would
> make it more difficult to find information at a glance.
>
> I personally never would have started using coreboot if I had to view
> the source tree for documentation, that scares people away and a text
> file is not at all equivalent to a nicely formatted wiki page.
>


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: OpenPGP digital signature
URL: <http://www.coreboot.org/pipermail/coreboot/attachments/20170228/98f75a00/attachment.asc>


More information about the coreboot mailing list