15 Commits

Author SHA1 Message Date
KATO Tomoyuki
108c17a774 Use https instead of http for openstack sites
Change-Id: I85b773045b30b93183ef0daa3bb5afb26d193a08
2017-01-31 07:36:48 +09:00
KATO Tomoyuki
41476b346a [contributor] use https instead of http for docs.o.o
Change-Id: Ife7a36926facd08ffda77810d83083b5f19f4783
2017-01-27 19:08:11 +09:00
Andreas Jaeger
2d44b2b36d Prepare for Sphinx 1.5
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
2017-01-11 20:37:55 +01:00
Lana Brindley
3656d3aece Adding info for new developers
Adding advice about creating bugs and asking for docs assistance. Based
on feedback from the Ops session in Barcelona.

Change-Id: I94cb48c1c0692067093bd148280b926a1014426e
2016-10-26 09:04:35 +00:00
Tanya Geles
ba9b7f03f1 [Contributor Guide] Clarify bug finding section
Clarifies the new contributor should select a bug that has been
confirmed by someone else.

Change-Id: I2967e89309cce4f558454e4e07971ab34d398327
2016-10-10 18:30:15 +10:00
Tanya Geles
d42bb7c863 [contributor guide] move steps for finding a bug
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
2016-10-09 19:10:25 +10:00
Luong Anh Tuan
52a59eda19 Fix a typo in documentation
remove redundant 'this'

Change-Id: I9a0bb3d82cd460cad10ff8c46e2ac3df87ff7761
2016-10-04 10:05:54 +07:00
Lana Brindley
b3ba9020bd Contributor Guide miscellaneous process updates
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
2016-07-25 22:14:21 +00:00
KATO Tomoyuki
30de34f74e [contributor] cleanup quickstart
* 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
2016-07-10 21:20:10 +09:00
KATO Tomoyuki
ea7ad4ecd2 [contributor] use notepad from Git Bash console
Change-Id: I7362667c9c77b33f2ef39acccd22582bb3ba709c
Closes-Bug: #1588579
2016-06-03 18:53:29 +09:00
KATO Tomoyuki
bdaf77f19e [contributor] remove editing DocBook from first timer
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
2016-06-02 07:45:35 +09:00
Andreas Jaeger
48628cf575 Update documents for ha-guide/operations-guide
Update contributor guide and release notes for retirement of ha-guide
and operations-guide. Also, update some minor bits noticed.

Change-Id: Ia51389b672fd45e54d7e6ece5cda56853714190e
2016-05-07 20:30:35 +00:00
venkatamahesh
1558048802 [contributor] Small changes to stay up-to-date
Change-Id: Idf9ca1885743c1722a58d795244d057670dfb1e3
2016-05-06 12:23:00 +05:30
Anne Gentle
f44592fe8d Windows SSH key for first contributors
Change-Id: I6599ca30676d7dce8a0fb88686cf103f208dc214
2016-05-04 17:37:34 -05:00
Lana Brindley
7c34ce5d69 Reorganised Quickstart chapter
Reorganised to add quickstart info for developers and new big tent
projects.

Change-Id: I698a49ff1628349d372f91136b2829be5f8c2ebc
Closes-Bug: #1553873
Depends-On: I72a7d57ae49ed2123475d3d1051c630e7b69dcaf
2016-03-22 05:42:11 +00:00