openstack/deb-sahara
Code Issues Proposed changes

Add examples of upstream files that we should not change

Browse Source 
Partial-Bug: #1277584
Partial-Implements: blueprint update-docs-icehouse
Change-Id: I37b25b4cec49dce9f3237953fe84f953c63eb849
This commit is contained in:
Trevor McKay 2014-04-02 18:59:06 -04:00
parent 6d829a588c
commit 083003cf6a
1 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/source/devref/development.guidelines.rst
View File

@ -24,6 +24,20 @@ in the upstream project and then merged back in to Sahara. This includes whites
changes, comments, and typos. Any change requests containing upstream file modifications
are almost certain to receive lots of negative reviews. Be warned.
Examples of upstream files are default xml configuration files used to configure Hadoop, or
code imported from the OpenStack Oslo project. The xml files will usually be found in
``resource`` directories with an accompanying ``README`` file that identifies where the
files came from. For example:
.. sourcecode:: console
$ pwd
/home/me/sahara/sahara/plugins/vanilla/v2_3_0/resources
$ ls
core-default.xml hdfs-default.xml oozie-default.xml README.rst
create_oozie_db.sql mapred-default.xml post_conf.template yarn-default.xml
..
Testing Guidelines
------------------