c939164c2d6128256146604effd9c97353673a1e
[pharos.git] / docs / release / configguide / lab_update_guide.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3 .. (c) 2016 OPNFV.
4
5
6 .. _pharos_wiki:
7
8 *************************
9 Updating Pharos Documents
10 *************************
11
12 Details about each Community Lab is found in 3 places:
13
14  - Summary of lab including location, contacts, status, etc.
15    on the `Pharos Project Wiki page <https://wiki.opnfv.org/display/pharos>`_
16  - Lab specific details are provided with dedicated Wiki pages,
17    see this `Example Lab <https://wiki.opnfv.org/display/pharos/Intel+Hosting>`_
18  - Pharos repo docs ...
19
20     - docs/information/pharos.rst ... project information file
21     - docs/labs/ ... Lab documents (includes lab specific capabilities, usages and policies;
22       POD information)
23     - docs/labs/images/ ... Lab and POD toplogies
24
25 Update Pharos repo
26 ------------------
27
28 Clone the Pharos Git repository
29
30  * Make the changes to Pharos project information file (docs/information/pharos.rst)
31  * After code gets merged http://artifacts.opnfv.org/pharos/docs/information/pharos.html will
32    contain your change
33
34
35 Update Pharos Wiki
36 ------------------
37
38 Edit Wiki page
39
40  * https://wiki.opnfv.org/pharos
41  * Look for {{scrape>http://artifacts.opnfv.org/pharos/docs/information/pharos.html}}
42  * Click "Preview" and see if your change is shown; if shown add a short "Edit summary" and click
43    "Save" (Wiki does not auto update content)
44
45 You will see a section of code as shown below. Add your page to the bullet list with wiki link, nice
46 name, and location summary
47
48 Update the map info on the Pharos Project Page https://wiki.opnfv.org/pharos?&#community_labs
49
50  * You will see a section of code as shown below. Add your lab infomation to the list with a comma
51    separated list as follows:
52
53     * longitude
54     * latitude
55     * .8 <- for size
56     * marker color png ([[marker-green.png|marker-green.png]], [[marker-blue.png|marker-blue.png]],
57       [[marker-red.png|marker-red.png]], [[marker-gold.png|marker-gold.png]])
58     * Nice Format Lab Name
59     * '';''
60     * Location Summary
61     * ''\\'' <-- for a new line
62     * external link: <-- optional
63
64 .. MAP Code Example (see Wiki page for current version)::
65
66 MAP::
67
68  <olmap id="olMapOne" width="877px" height="200px" lat="45.0" lon="0.0" zoom="3" statusbar="1" toolbar="1" controls="1"
69  poihoverstyle="0" baselyr="OpenStreetMap" gpxfile="" kmlfile="">
70  45.52,-122.67,60,.8,marker-red.png,Linux Foundation;Portland, Oregon \\ external link: [[http://www.test.com|test.com]]
71  39.7392,-104.9902,60,.8,marker-red.png,Cable Labs;Denver, CA \\ external link: [[http://www.test.com|test.com]]
72  37.333685,-121.891272,60,.6,marker-green.png,[[pharos/spirentvctlab|Spirent VCT Lab]] \\ San Jose, California
73  39.90,116.35,60,.8,marker-red.png,China Mobile Labs;Beijing, China \\ external link: [[http://www.test.com|test.com]]
74  37.413137,-121.977975,-180,.6,marker-red.png,Dell Labs;Santa Clara, California \\ link: [[https://wiki.opnfv.org/dell_hosting]]
75  59.41,17.95,60,.8,marker-red.png,Enea Pharos Lab;Kista, Sweden \\ external link: [[http://www.enea.com/pharos-lab|ENEA pharos lab]]
76  45.50,-73.66,60,.8,marker-blue.png,Ericsson Labs;Montreal, Canada \\ external link: [[http://www.test.com|test.com]]
77  34.26,108.97,60,.8,marker-green.png, Huawei Labs;Xi an, China \\ external link: [[http://www.test.com|test.com]]
78  37.373424,-121.964913,60,.8,marker-green.png, Huawei Labs;Santa Clara, USA \\ external link: [[http://www.test.com|test.com]]
79  45.53,-122.97,60,.8,marker-green.png,Intel Labs;Hillsboro, Oregon \\ link: [[https://wiki.opnfv.org/get_started/intel_hosting|intel_hosting]]
80  48.75867,-3.45196,60,.8,marker-gold.png,Orange Labs;Lannion, France \\ external link: [[http://www.test.com|test.com]]
81  48.825786,2.274797,-60,.8,marker-gold.png,Orange Labs;Paris, France \\ external link: [[http://www.test.com|test.com]]
82  31.97,118.79,60,.8,marker-red.png,ZTE Labs;Nan Jing, China \\ link:[[zte-nj-testlab|ZTE, Nan Jing]]
83  [[http://test.com|test.com]] \\ internal link: [[::start]]\\ **DW Formatting**
84  </olmap>