Talk:Sugar Network/Recipe Specification

Change Logs

Not sure that dates are so important as all the changes are tracked in git anyway. Version number would be important, however. But how does this differ from the info nominally kept in NEWS? Would we still need the NEWS file? --Walter 22:46, 7 February 2011 (EST)

For dates, yeah. In any case, people might use additional keys if they prefer. Might be NEWS as well, though some people (like me) will prefer "self contained" spec files (ie w/o NEWS). So, I guess having assumption that change log can be either in NEWS or in spec file, should be fine. Another reason to have changelog in spec (or in ini file format, ie not like arbitrary NEWS), is that it will be possible to use regular notation for translated strings, eg:

[v1]
changelog = en-text
changelog[ru] = ru-text

alsroot 22:57, 7 February 2011 (EST)

I am fine with using a spec file instead of NEWS, but I am loathe to add yet another place where I track my changes (git commit messages, ASLO release notes, activity page in the wiki, NEWS, and now the spec file). Maybe we either phase out the NEWS file and/or automatically add its updates to the spec file when running "setup.py fix_manifest"? --Walter 08:08, 8 February 2011 (EST)
Return to "Sugar Network/Recipe Specification" page.