infra docs

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Following up on the action item for the infra-docs/SOP migration from
the wiki to git I was wondering what opinions folks had on these two
markup mechanisms:

markdown

Restructured Text


Suggestions include:

1. having each page be plain text and have the following format:
 Title: blah
 Summary: blah blah blah
 
 Body goes here

Then having a commit hook for the git repo  generate a simple index of
the above for browsing on a web site.


2. Just put the txt files in a dir and let you browse based on filename
and be done with it. - since a lot of us are going to just use git grep
ANYWAY, just roll with it.


I'm inclined toward simple and add complexity as we go.

-sv



_______________________________________________
infrastructure mailing list
infrastructure@xxxxxxxxxxxxxxxxxxxxxxx
https://admin.fedoraproject.org/mailman/listinfo/infrastructure


[Index of Archives]     [Fedora Development]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Yosemite News]     [KDE Users]

  Powered by Linux