User:Crantila/What up Docs

From FedoraProject

Jump to: navigation, search

This page is about collecting people's thoughts about what's up with Docs in November 2013.

  • Leslie Satenstein proposes LibreOffice (with revision management) replace DocBook [12]
    • Joe Brockmeier notes "many-at-once" is a problem with LibreOffice revision management [13]
    • Pete Travis says distributed version control is more efficient than the paper-workflow-inspired LibreOffice suggestion [14]
    • Christopher Antila agrees distributed version control is important [15]
  • Chris Murphy suggests we accept many formats for initial submission of documentation, then convert it [16]
  • Eric Christensen says LibreOffice can export to DocBook XML, but not particularly effectively [19]
  • Leslie Satenstein asks if Transifex allows peer review [20]
  • Leslie Satenstein suggests enable offline work on mobile devices [22]
  • John J. McDonough notes that translation teams in different languages work differently; implies it's Docs' responsibility to get things into Transifex and stop worrying [23]
  • Kevin Glazenburg agrees the current workflow is difficult to learn, and suggests simple tasks for starting out [25]
  • Eric Christensen is wary of adding a third source of documentation (over docs.fp.o and the wiki) because it's already difficult to search [33]
  • Eric Christensen reinforces that we shouldn't give up our existing tools, and proposes instructional videos [39]
  • Chris Murphy supports instructional videos [40]
  • Christopher Antila says he feels discouraged from updating Guides between Fedora releases, and suggests de-coupling many Guides' publication from Fedora releases [43]
    • Eric Christensen doesn't know why Christopher feels that way, since he (Eric) re-publishes the Amateur Radio Guide between Fedora releases [44]
    • Pete Travis also suggests a sort of "rolling release" for certain Guides [45]
  • Chris Murphy wonders if fear of criticism is a factor leading to lower-quality documentation and less engagement [52]
  • Chris Murphy seems to have (correctly) guessed the procedure for filing bugs against documentation [53]
  • Leslie Satenstein suggests a "social" job-tracker for Docs tasks [54]
  • Leslie Satensetin says we should ask the community how they'd like to be engaged [56]
  • Leslie Satenstein suggests targeting retirees as potential contributors [57]
  • Leslie Satenstein questions the anglo-centric development process [58]
    • Christopher Antila notes one Guide was first contributed in Spanish; it's because our tools are designed for one source language and Red Hat is American; and collaborating across linguistic barriers is potentially risky [59]