The new sphinx version introduces some changes that break build:
* Warns if code cannot be parsed for highlighting. Fix the code so
that it can be parsed, this includes uncommenting "..." lines.
Note that not every config file is an ini-file.
Also, the parser seems to have bugs and cannot parse all files.
Fix mysql ini file and enable the parameter, see
http://dev.mysql.com/doc/refman/5.7/en/innodb-parameters.html#sysvar_innodb_file_per_table
* :option: works only with declared options, replace useage with
simple ``.
This change only handles a few files, more to come later.
Change-Id: I7c7335e514581622dd562ee355f62d6ae1beaa18
Adding advice about creating bugs and asking for docs assistance. Based
on feedback from the Ops session in Barcelona.
Change-Id: I94cb48c1c0692067093bd148280b926a1014426e
The list of first time docs tasks can't be performed until after the
contributor has set up. Moved to after the contributor set up
information.
Deleted second suggestion to triage bugs as irrelevant to tutorial work
flow. Amended language.
Change-Id: Id34979984b15eea5d2de3ffac62cda34070d95e9
Closes-Bug: 1631710
Working from the Newton docs deliverables list from the Austin Summit:
* Who should follow this guide?
* Introduction of a minimal review time?
* Section about contribution recommendations: what devs should
contribute, review expectations of docs, expected turn-around time, etc.
* How to deprecate/remove docs?
* Also define which are continuous-release, versioned, etc.
Change-Id: I9df39977a8e9ca81960c6ee8840e864054d9b1d2
* Since api-site doesn't manage API bugs at now,
it is not appropriate for the first timer.
* A first timer isn't familiar with the bug triage process.
Change-Id: I13bd06b385074d991f3405fcbfc121d4552e463f
Implements: blueprint contributor-guide-reorg
We have a few DocBook document at stable branch,
but it is not appropriate for first timer to fix it.
Change-Id: I4f87a5f9ce7ca0d1766bfa00747645823c13b62c
Implements: blueprint docbok-removal
Update contributor guide and release notes for retirement of ha-guide
and operations-guide. Also, update some minor bits noticed.
Change-Id: Ia51389b672fd45e54d7e6ece5cda56853714190e
Reorganised to add quickstart info for developers and new big tent
projects.
Change-Id: I698a49ff1628349d372f91136b2829be5f8c2ebc
Closes-Bug: #1553873
Depends-On: I72a7d57ae49ed2123475d3d1051c630e7b69dcaf