Commit Graph

26 Commits

Author SHA1 Message Date
Doug Hellmann f4e2d83b00 rearrange the existing docs to follow the new standard layout
Change-Id: Ia033a9243a55f4a7dfd70d5e0515d6d3372d6e08
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-28 14:43:44 -04:00
liuxiaoyang 0d45aee7dc Replace http with https
The use of https and some of them are http.
Use https instead of http to ensure the safety without containing our
account/password information.
e.g. https://review.openstack.org/#/c/462890/

Change-Id: I545833e4d7ede4435e4f50bed792a60847e9a813
2017-06-19 08:59:07 +08:00
Doug Hellmann f957e74ff9 add option for ignoring some notes files
Make it easier to produce clean release notes by ignoring files
mistakenly edited on the wrong branch.

Change-Id: I74fb9e6c74af0b9de8cfe0d9c07ecfbd09cae925
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-13 13:42:07 -04:00
Jenkins 3b2b36fede Merge "ignore null-merges" 2017-06-13 00:53:08 +00:00
Doug Hellmann bd6fecc858 ignore null-merges
OpenStack used to use null-merges to bring final release tags from
stable branches back into the master branch. This confuses the regular
traversal because it makes that stable branch appear to be part of
master and/or the later stable branch. Update the scanner so that when
it hit one of those merge commits, it skips it and take the first parent
so it continues to traverse the branch being scanned.

Change-Id: I90722a3946f691e8f58a52e68ee455d6530f047a
Closes-Bug: #1695057
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-02 10:18:04 -04:00
Matt Riedemann a26e9820dd Document how reno handles eol branches in config
This comes up from time to time so we should probably
document it.

Change-Id: I58fef297612328ee1db61377c29e1cfe0ec6f5ab
2017-06-01 14:30:43 -04:00
Doug Hellmann 06d6574d46 add a lint command
Provide a tool for doing some basic input validation.

Related-Bug: #1688042
Change-Id: I850b57153c5286e19f4ac3af899b3d798aebd7d4
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-05-03 15:53:44 -04:00
Stephen Finucane 252b48f171 doc: Document the available configuration options
They're documented in the source. Let's document them in the actual
documentation.

Change-Id: Ia320808630281009c1700cb1ad25340761af86a0
2017-03-31 09:33:45 +01:00
Adam Spiers 081a4145e1 make sections configurable
The list of section identifiers and corresponding display names, and the
order in which they are rendered, was hard-coded.  Some projects want to
customise this, so move it into the Config object so that it can now be
specified via config.yaml, e.g.

    sections:
      - [features, New Features]
      - [issues, Known Issues]
      - [upgrade, Upgrade Notes]
      - [api, API Changes]
      - [security, Security Issues]
      - [fixes, Bug Fixes]

Change-Id: I914572c6a07ca81c54965b4b5a6b6aba50b3a787
2017-02-23 15:04:22 -05:00
Adam Spiers 7ecf63312f fix reference to config.yaml
The configuration file has to be named config.yaml, so fix the
documentation not to refer to config.yml.

Change-Id: Icb2ef9f99a043a4e9a460f984436dcfdbe0cb41b
2017-02-20 12:01:31 -05:00
Doug Hellmann 962e9086e0 documentation improvements
Expand the readme to include more description of the benefits of using
reno.

Clean up the organization in index.rst.

Remove an unused readme.rst from within the documentation tree --
nothing imported it or linked to it.

Clean up phrasing and formatting in the usage page.

Change-Id: Id3f0b71f199f7ad15d5fc0b3df67e05b7a8f2b19
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-02-06 11:28:30 -05:00
Zane Bitter d90bb77ab2 Link to reStructuredText primer from usage docs
Change-Id: I1282801ffead6393a557cc80164f138603b91019
2016-12-01 11:25:36 -05:00
Cedric Brandily 92a9bcdb14 Enable to create and edit a note with reno new
Commonly, we edit a note just after its creation with reno new command.

This change enables to do both with reno new --edit, it creates a new
note and edits it with your editor (defined with EDITOR env variable).

Change-Id: I7866277c8ceaae41b9b9d0225ee33dcc37f3be6b
2016-11-11 20:46:49 +01:00
Cedric Brandily 4964ab786d Support to set a custom template used to create new notes
Currently the template used to create new notes is hardcoded in reno
source code. It's fine when reno is used inside OpenStack community but
external projects would perhaps like to use a custom template in order
to better match their needs.

This change supports to set through "template" attribute in config.yaml
a custom template which will be used by reno new to create new notes.

Change-Id: I83a870eb9906c26e5ee946d53b9c154867180971
2016-11-11 16:16:36 +01:00
Doug Hellmann 7ee2a78a8a add configuration option to not stop at branch base
The previous commit changes the default behavior to always stop scanning
at the base of a branch. This change adds a configuration option to
allow that behavior to be disabled, so that revisions along the history
of the branch prior to the point where it diverged from master can be
included. The new default behavior established in the previous commit is
not changed.

Change-Id: I2c4968e1291c1b7d268896cfbb79e320d4085bce
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-10-13 18:55:40 +00:00
Doug Hellmann fbd074bc4b add reference to project team guide for openstack projects
We do not want to put instructions that are specific to OpenStack in a
general-purpose tool, but it's OK to link to those instructions
elsewhere since a lot of people will start by looking at the reno
documentation.

Change-Id: I73f9fd71cfc24d67420adb70509a2775ad022627
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-09-29 14:22:21 -04:00
Andreas Jaeger 9d0a4ba2ce Fix RST
code-block on its own will surpress the argument, add console so that
the next line gets displayed. Also add "$" to signify the command line
interaction.

Change-Id: I2107356a1063f7f7e1c5c68ef821aebe2897969d
2016-09-02 10:55:05 +02:00
Jim Rollenhagen 9cff0d7d90 Add debugging section to docs
Adds a 'debugging' section to the usage documentation, with a quick note
to help users uncover errors masked by sphinx includes.

Change-Id: I9c24931c3acb0ab7588221f278287549eee0b3cd
2016-08-09 13:24:44 -04:00
Ian Cordasco 750bdc021b Add YAML configuration parsing
While discussing I7539fdeada14a73ae4e18a125bb0e3947f08e8d1 Doug and
Harry realized that it would be much better if some of these values
could be specified in a config file, whether INI or YAML.

This adds a simple function to allow options to be specified in the
config file named "config.yml" in the --rel-notes-dir.

Change-Id: Ie25e1eb3da66cc627d93af585b0893469d6a7b2e
2016-07-22 17:56:30 -04:00
Mike Perez 13b932f0f2 Add deprecations section to usage documentation
This includes information on the section deprecations and
a consideration when using it.

Change-Id: I581a8afa3491eef74af1472c57d0c35273f45f89
2016-03-01 11:04:07 -08:00
Ian Cordasco aeb9c812fe Fix reference to old subcommand in usage
The current correct subcommand is "new"

Closes #1526091

Change-Id: Ic0a6707394a3568051b5d9aef6b77faa6df36c4d
2015-12-14 17:06:05 -06:00
Doug Hellmann d3efb6cfc8 add complex formatting example
Set up an example directory to hold example notes and add one showing
how to use complex formatting.

Change-Id: I7b3e27c394789cc1ff832ca0bf26f3244b058eb7
2015-11-23 19:17:02 +00:00
Louis Taylor acbe54771d Fix example output filename in docs
Change-Id: I48783c219320be7bf3179e785ce42ccdfe67768e
2015-11-04 08:21:22 +00:00
Doug Hellmann 12ff6ec46c update docs for slug/uuid swap
Change-Id: I009fc7a96b68b41f2b405ac225197f49c2093bb3
2015-10-02 12:57:42 +00:00
Doug Hellmann 46caf8f7e6 add better usage instructions
Change-Id: I2d435dcb187293e0b5c072ccadcf8aa4229b4505
2015-10-01 20:37:41 +00:00
Doug Hellmann da8db96445 Initial Cookiecutter Commit. 2015-08-26 20:04:56 +00:00