summaryrefslogtreecommitdiffstats
path: root/docs
AgeCommit message (Collapse)AuthorFilesLines
2016-02-09userguide: add new templateRyota MIBU2-0/+12
This patch adds new template 'testusage.rst' and 'featureusage.rst' in the same manner of configguide. This makes us easier to compile files into correct places. Change-Id: I1aaacb07098b068f42b0f7b7cd1f724de617c932 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-02-08configguide: make sections relevant by adding sub-level toctreeRyota MIBU16-14/+103
This patch wrap each import document with 'toctree' directive so that we can make sure the sections in imported docs won't take any upper level section. This patch also fixes the followings: * path to copper/featureconfig.rst * path to promise/configguide/images/ Change-Id: I52d4e9cd637af5707af418ef287d57d8c301b85e Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-02-05Adding general component descriptions and information.ChristopherPrice10-41/+151
Change-Id: Ie9824ac9c706f730c929a5ca0ed34ee85314719e Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-02-04Add ipv6 docs entries in feature-config.rst, post-install.rst, userguide.rst ↵Bin Hu3-0/+3
and build-composite.sh Change-Id: I3783c30d4adfe4ebe913cfeeace3e76d5bb57f38 Signed-off-by: Bin Hu <bh526r@att.com>
2016-02-03Small update for apex and setting some info on component, to be completed.ChristopherPrice4-1/+13
Change-Id: I78711a79ae483a0f1abc49a154cf0360e3ebf6d8 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-02-03Adding new projects content and license information.ChristopherPrice25-27/+145
This includes content from a variety of projects participating in Brahmaputra. We need to move to editorial work shortly, establishing a consistent style now that we have sufficient content in place to work with. Change-Id: I3a54358186ec788bf8cb60b2e44517c36ff53fa2 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-02-02fix section headers in consistent ruleRyota MIBU21-69/+32
'*' with overline: document title (placed before toctree) '=' with overline: sections '=': subsections '-': subsubsections Change-Id: Ia91ec0c4f95185eac911e972a07ebc7fdae372f4 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-02-01Updating scripts including composite doc input.ChristopherPrice2-0/+4
Added functest repo to include validation text in userguide and configguide. Also updated the script based on Ryota's input https://gerrit.opnfv.org/gerrit/8849 Ready to merge although another patch will be needed once the toolchain is in place to continue to integrate content. Change-Id: I4d7adbd174cea29aada99fcdbd42d4c182456739 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-01-28Including text and graphic placeholders for the user and config guides. (I ↵ChristopherPrice14-14/+206
like apostrophes'') This patch contains the introduction and framing text for the user and config guide. Work is required to add the scenario/feature mapping section and information. Change-Id: I71c9fa7cfbac2d0100c743a8855df4a02cc7482c Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-01-28Platformoverview structured in separate files per section and added some contentulik6-180/+250
Jira: DOCS-42 Next step to create platform overview document. Proper use of index.rst, separate files per major section. Started to provide content. Change-Id: I542ae1ed334d9832bbed24926213ce651d2ae4ce Signed-off-by: ulik <ulrich.kleber@huawei.com>
2016-01-20Renamed config-overview to userguideSofia Wallin1-0/+0
Change-Id: Ie8e4806686a251ee45e11a8b0447edd6a7407168 Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-01-20Added template for config-overviewSofia Wallin1-1/+1
Added template for config-overview to be used by the featuers. Change-Id: I4ed713bb1b4a257a70cba7a6ed51d6f71feb3bcd Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-01-20Added template for config-overviewSofia Wallin1-0/+7
Added template for config-overview to be used by the featuers. Change-Id: Id9d63af4f3f6ab469243800982e46aad236c2030 Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-01-19Updating the index.rst file to include referred content.ChristopherPrice7-47/+49
Adding new committers in the INFO file. This patch includes updates to the index files to establish the correct structure for the composite docs in Brahmaputra. The patch also includes an updated INFO file adding Ryota Mibu and Sofia Wallin as committers to the project. add the include references. Change-Id: Ife98bd25ac3c80d2737132867449ee11f45a581e Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-01-14Reverting the reffered file reference to direct manual additions.ChristopherPrice1-8/+4
Removed the generated file refernce in the index.rst file and referring to each project file specifically in the index.rst file. Change-Id: I00eba02a292d74b2959fa071db3a7e857ce06300 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-01-08Small editorial changes to the template documents.ChristopherPrice9-42/+55
Added reference sections without local placeholders. Restructured the user-guide index template. Change-Id: I8b2e6abbe151a8fb9f3721e761a65f70fada1e85 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-01-07Use auto project links generated by jenkinsRyota MIBU4-6/+6
Note: https://gerrit.opnfv.org/gerrit/5767 is needed for this change. Change-Id: I809edabea89129d9472852ceb07c323be97bdf45 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-01-07Use include directive to include project docs in opnfvdocsFatih Degirmenci2-7/+9
Change-Id: I7d70348cea93dddaeefc251554cbe564f8720c40 Signed-off-by: Fatih Degirmenci <fatih.degirmenci@ericsson.com>
2016-01-05Adding template files for the configguide composite documentChristopherPrice5-14/+74
Added the feature configuration and post install/config template files for use in the composite configguide document. Fixed trailing whitespace, and added ./ specificity to the local doc references. Change-Id: I7778993d01d978b60d46375b334d59dbdc2b855a Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2015-12-28Merge "Updated the config guide templates"Christopher Price4-9/+44
2015-12-28Updated the config guide templatesSofia Wallin4-9/+44
Updated the config guide templates.Some sections still need work. Please feel free to change/add or update where needed. Change-Id: Iaec8616a0d808a7b2c2f72433c630a36afaf4703 Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2015-12-18Merge "Fix Line Length etc for existing docs"Christopher Price18-72/+174
2015-12-18Fix Line Length etc for existing docsUli Kleber18-72/+174
Jira: DOCS-68 Fixing errors reported by the new tooling. platformoverview/index.rst will be fixed with the new platformoverview document (see separate patch) corrected importing logo images Change-Id: I08f73dcfeef4f2ff3a38a0372491a46798b4026b Signed-off-by: Uli Kleber <ulrich.kleber@huawei.com>
2015-12-18Merge "Skeleton and first draft content platformoverview"Christopher Price2-7/+176
2015-12-18Merge "Created a template for installer configuration"Christopher Price1-0/+23
2015-12-17Created a template for installer configurationSofia Wallin1-0/+23
Change-Id: I1accfa33b28b00724e175b1e08a5cd34c1d85245 Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2015-12-17Skeleton and first draft content platformoverviewUli Kleber2-7/+176
Jira: DOCS-42 Skeleton is showing, which sort of content is expected. Some content could already be provided, in other cases there are Editor's notes describing the way to go. worked on comments. mistake in index.rst fixed Change-Id: I075dc20398a87087910cb2d997db51f30f2d12e0 Signed-off-by: Uli Kleber <ulrich.kleber@huawei.com>
2015-12-11Merge "updates to use new doc toolchain"Christopher Price2-35/+0
2015-12-11updates to use new doc toolchainRyota MIBU2-35/+0
Change-Id: I68bffb1a0803d8aabb95d88ab70e243fb3fc75be Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2015-12-09Adding structure to the Config guideSofia Wallin5-9/+40
Removed content text from the index file. Created content files, added sub sections for installers and features. Change-Id: I630ac62546b6cd8facc793e595f647b5a5d8c45f Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2015-11-24JIRA: DOCS64ChristopherPrice6-0/+89
Adding three test files to establish the cross repository workflow and build out the templates for the Brahmaputra release documents. Change-Id: I9afdaccfae5e583fdca43789ee65940f83514d34 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2015-11-10Added opnfv-security-guideLuke Hinds14-0/+169
Modified conf.py to include RTD theme.... html_theme = 'sphinx_rtd_theme' Change-Id: I9b004725ba4ca6606ad8b9e8700f4395ccdeafaa Signed-off-by: Luke Hinds <luke.hinds@nokia.com>
2015-11-10Move documents to new directory structureAric Gardner9-0/+102
added index.rst Change-Id: I5af95b40afd5443176c1054085b597a435c31b1b Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
2015-09-13Updatng the doc tracking text to show _sha1_ and _date_ as required in the ↵ChristopherPrice1-5/+2
rst files. JIRA: BGS-48 Change-Id: I6dfd566af582d8da416065f7e4db728076d62a12 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2015-07-24Add syntax highlighting for bash blocksAric Gardner2-3/+7
Also remove some []'s that were casuing rst2pdf to intepret a line as an ipv6 url Change-Id: I5e0cd0d455cc25e24853c37ac9329394c763828d Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
2015-05-27Test docu-build.sharno.2015.2.0arno.2015.1.0stable/arnoFatih Degirmenci1-1/+1
JIRA: OPNFVDOCS-XXX Change-Id: I1f1b349fe8f80d6d5c9c8fbbc9750cf92e78a51a Signed-off-by: Fatih Degirmenci <fatih.degirmenci@ericsson.com>
2015-05-25Small fix for sed _sha1_ and _date_ replacementVictor Laza1-5/+16
JIRA: DOCS-35 - Added also a comment on how to proceed in the code. Change-Id: I96ce01ea8b4213e5a0dce08792118137a4eed0bd Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-05-14Update docs/enable_docu_gen.rst scripts to include "rst2html --halt=warning"Victor Laza1-17/+74
JIRA: DOCS-32 - Update docs/enable_docu_gen.rst scripts to include "rst2html --halt=warning" and added a more clear tree structure for repository Change-Id: Iaabce4dcb04464cae1ec6404a6e86aee275e339c Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-05-11Merge "Add Wiki - how update works in enable_docu_gen.rst"Christopher Price1-0/+6
2015-05-11Merge "Documentation templates for: LICENCE Installation Build Release-notes"Christopher Price4-4/+241
2015-05-05Add Wiki - how update works in enable_docu_gen.rstVictor Laza1-0/+6
JIRA: DOCS-27 - Add Wiki - how update works in enable_docu_gen.rst Change-Id: Ifcf96ffecbffc539a92ea43167ee81f44733f659 Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-04-30Update opnfvdocs/docs/enable_docu_gen.rst with latest scriptsVictor Laza2-18/+21
JIRA: DOCS-25 - Update opnfvdocs/docs/enable_docu_gen.rst with latest scripts that extract project name from git rather that hard-coded Change-Id: Iadb6fdf80653f45926037c6898e44ea18c33ee6c Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-04-28JIRA: #2 update docs/enable_docu_gen.rst with latest image include codeVictor Laza1-21/+19
Change-Id: Ie77e13aa5358f13011852739e792ab23ce5026c4 Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-04-28Updated docs/enable_docu_gen.rst with latest image include codeVictor Laza1-0/+35
JIRA: Updated docs/enable_docu_gen.rst with latest image include code that will make visible images in .html artifacts also Change-Id: Ie2938a1feeb815ddf51cafb53c96df3690ec6f4c Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-04-27Including "node: master" for jjb enable-docu-gen jobsVictor Laza1-0/+6
JIRA: Including "node: master" for jjb enable-docu-gen jobs Change-Id: Ib6817d6cf8cad51c292f1347e030842050617432 Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-04-27Upload and include a smiley face into one of the documentationsVictor Laza2-0/+10
JIRA: Using this to test the image upload script and html scrape with included images. Change-Id: I4d1baab8f4bd7cd89ddf1f714c5b5a68624bf097 Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-04-23Documentation templates for:Jonas Bjurel4-4/+241
LICENCE Installation Build Release-notes JIRA: Change-Id: Ia0ed1ef2042c2ee84ae0b9db78bd117e3ca8de6a Signed-off-by: Jonas Bjurel <jonas.bjurel@ericsson.com>
2015-04-20Updated docs/enable_docu_gen.rst to include the new updated scriptVictor Laza7-69/+170
JIRA: Updated docs/enable_docu_gen.rst to include the new updated script and added **Documentation trackin** to all docs in opnfvdocs Change-Id: Ifc0390b8f5b96290f37143a49b543ce5e123ed24 Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-04-17Removed requirements/main.rst to rest if build-docu.sh skips missingsVictor Laza3-7/+5
JIRA: Removed requirements/main.rst to rest if build-docu.sh skips missings and fixed some small typos + sha1 & date injection Change-Id: I72a52136d4f0380f53ce2ca2a2a9e1f8db92b518 Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>
2015-04-17Improved cosmetics of enable_docu_gen.rst & other_options_for_docu_gen.rstVictor Laza3-36/+42
JIRA: Removed some unneeded whitespaces, added link to reSt online editor with live preview, link to documentation structure, more quick guides into reSt, reworked link to PDF artifact Change-Id: Ide489410bf8fa3bf5910b5b2e328c61a7d6b0348 Signed-off-by: Victor Laza <vlaza@cloudbasesolutions.com>