diff options
author | 2016-01-19 11:53:14 -0800 | |
---|---|---|
committer | 2016-01-22 13:42:03 -0800 | |
commit | c4e926c285db44a5ec5ba4a895c8d3889e3358c0 (patch) | |
tree | bb37ed035989bcca11e1cbcfe7b3085ad17429cf /docs/configguide | |
parent | 971188744137c6d0dc75cb89740bbb759651d304 (diff) |
Organized document directories, added index.rst files ...
./ only file here should be project facts (INFO)
./docs/ no files should be here (jumpserver_install and pharos-spec files will be removed)
./docs/configguide/ overview of community lab expecations, reference to all other files wtih descriptions, get started for a new lab (e.g. how to update pharos start page)
./docs/images/ diagrams for pharos project (Wiki etc. not a particular lab)
./docs/information/ contains pharos project information ... pharos.rst
./docs/lab-description/ templates and config file examples (human readable (rst) and machine readable (yaml) files)
./docs/labs/ all lab specific documentation (filled templates, etc.)
./docs/labs/images/ lab specific diagrams
./docs/specification/ files that are part of the pharos spec
Change-Id: I3a7a1434ae4b8f6f0d66d0ce5b6a1b00853378d5
Signed-off-by: Trevor Cooper <trevor.cooper@intel.com>
Diffstat (limited to 'docs/configguide')
-rw-r--r-- | docs/configguide/index.rst | 15 | ||||
-rw-r--r-- | docs/configguide/lab_update_guide.rst | 72 |
2 files changed, 87 insertions, 0 deletions
diff --git a/docs/configguide/index.rst b/docs/configguide/index.rst new file mode 100644 index 00000000..4af40a59 --- /dev/null +++ b/docs/configguide/index.rst @@ -0,0 +1,15 @@ +Pharos Project Information +==================== + +.. toctree:: + :maxdepth: 2 + + ./pharos.rst + +:Authors: Trevor Cooper (Intel) +:Version: 1.0 + +Indices and tables +================== + +* :ref:`search` diff --git a/docs/configguide/lab_update_guide.rst b/docs/configguide/lab_update_guide.rst new file mode 100644 index 00000000..fb41f4bc --- /dev/null +++ b/docs/configguide/lab_update_guide.rst @@ -0,0 +1,72 @@ +How to update the lab info on this wiki +======================================== + +Details about Hosted Community OPNFV Test Labs are located in 3 different places: + + - Summarized on the OPNFV wiki [[start#opnfv_community_labs|Start Page]] + - Overview with additional details on the [[pharos#opnfv_test_labs|Pharos Test Bed Governance Project Page]] + - With Project specific information on each project page + +---- + +How to update the Start Page +----------------------------- + +* Clone the Pharos Git repository and make the changes:: + + git clone ssh://<lfid>@gerrit.opnfv.org:29418/pharos + + vi docs/pharos.rst + # use the below guide for MAP + + git add docs/pharos.rst + + git commit --signoff + # use the proper commit message & include JIRA id + + git review -v + # go to gerrit web and add reviewers, wait to have it merged + # after code gets merged http://artifacts.opnfv.org/pharos/docs/pharos.html will contain your change + + # edit Wiki page https://wiki.opnfv.org/pharos and look for {{scrape>http://artifacts.opnfv.org/pharos/docs/pharos.html}} + # click "Preview" and see if your change is shown; if shown add a short "Edit summary" and click "Save" + # This must be done as Wiki does not auto update content for now + +* You will see a section of code as shown below. Add your page to the bullet list with wiki link, nice name, and location summary + + +How to update the map info on the Pharos Project Page +------------------------------------------------------ + + * Login and edit the OPNFV wiki [[pharos#opnfv_test_labs|Pharos Project Page]] + * You will see a section of code as shown below. Add your page to the list with a comma separated list as follows: + * longitude + * latitude + * .8 <- for size + * marker color png ([[marker-green.png|marker-green.png]], [[marker-blue.png|marker-blue.png]], [[marker-red.png|marker-red.png]], [[marker-gold.png|marker-gold.png]]) + * Nice Format Lab Name + * '';'' + * Location Summary + * ''\\'' <-- for a new line + * external link: <-- optional + +MAP:: + + <olmap id="olMapOne" width="800px" height="200px" lat="45.0" lon="0.0" zoom="3" statusbar="1" toolbar="1" controls="1" poihoverstyle="0" baselyr="OpenStreetMap" gpxfile="" kmlfile=""> + 50.0117,5.1287,-90,.8,marker-green.png,Pont de Barbouillons; Daverdisse \\ external link: + 39.90,116.35,60,.8,marker-red.png,China Mobile Labs;Beijing \\ external link: + 45.50,-73.66,60,.8,marker-blue.png,Ericsson Labs;Montreal \\ + 34.26,108.97,60,.8,marker-green.png, Huawei Labs;Xi an \\ + 45.53,-122.97,60,.8,marker-green.png,Intel Labs;Hillsboro \\ + 48.75867,-3.45196,60,.8,marker-gold.png,Orange Labs;Lannion \\ + 48.82,2.27,60,.8,marker-gold.png,Orange Labs;Paris \\ + [[http://test.com|test.com]] \\ internal link: [[::start]]\\ **DW Formatting** + </olmap> + + +**Documentation tracking** + +Revision: _sha1_ + +Build date: _date_ + |