Closed mchf closed 7 years ago
@mvidner Could you please also check it?
Thanks! Some preliminary notes:
doc
directory. Please move these files there and adjust .yardopts
to include design.md in the rendered docs.M-x
flyspell-buffer
(checks the whole file once) and M-x
flyspell-mode
(will check around text being edited).Please improve the design document by giving the existing structure clear names:
Instead of "1st layer, 2nd layer, 3rd layer", use "Bottom layer: Pasta, Middle layer: Salami, Top layer: Peppers (fixme, use actual ingredients)"
In the limitations section, make 3 subsections with short descriptive titles too.
@mvidner almost all (but hyperlinks in design) comments were integrated.
Thanks! Are you adding the class links to design.md? Don't forget to spell check that file too.
@mvidner added links even into design.md
Thanks for the reviews
I've just removed the blog draft as it was already published: https://lizards.opensuse.org/2017/05/17/cfa-config-files-api-at-a-glance/
TBD: sync blog.md and design.md again once the last one is in final state --- DONE