AC, I like the idea of you putting some style recommendations together (as you’ve done) and moving forward with standardizing the docs to meet them.
Jess On May 13, 2014, at 4:48 PM, Cheetham, Anastasia <[email protected]> wrote: > > Work on converting out documentation to markdown in Github is moving along. > We have a number of pages now in the repository: > > https://github.com/fluid-project/infusion-docs/ > > The status of the work can be tracked on the Docs Plan wiki page: > > http://wiki.fluidproject.org/display/fluid/Infusion+Documentation+Plan > > > In reviewing the pages, I notice that there are minor inconsistencies across > pages, for example, whether or not a word is rendered in 'code' style. In > response, I've started drafting a style guide for our documents: > > http://wiki.fluidproject.org/display/fluid/Infusion+Documentation+Style+Guide > > The points I've put there are just a start at some recommendations – talking > points. We should think this through as a group and agree on the conventions > we'll use to ensure that our documentation has a consistent look and voice. > > Since we haven't actually agreed on any conventions yet, I went ahead and > merged the existing docs despite the inconsistencies. Once we have a style > guide, we can take a pass through the docs and ensure that they all conform > to whatever style we decide on. > > Thoughts? > > -- > Anastasia Cheetham Inclusive Design Research Centre > [email protected] Inclusive Design Institute > OCAD University > > _______________________________________________________ > fluid-work mailing list - [email protected] > To unsubscribe, change settings or access archives, > see http://lists.idrc.ocad.ca/mailman/listinfo/fluid-work ~~~~~~~~~~~~~~~~~~~~~~ Jess Mitchell GMT - 4:00 +1.416.977.6000 x.3965 Senior Manager, R&D + Design OCAD University, Toronto Inclusive Design Research Centre [email protected] skype: jesshmitchell http://idrc.ocad.ca/ http://inclusivedesign.ca/ http://fluidproject.org ~~~~~~~~~~~~~~~~~~~~~~ _______________________________________________________ fluid-work mailing list - [email protected] To unsubscribe, change settings or access archives, see http://lists.idrc.ocad.ca/mailman/listinfo/fluid-work
