summaryrefslogtreecommitdiffstats
path: root/docs
AgeCommit message (Collapse)AuthorFilesLines
2017-02-11Added steps to build documentationShubhamRathi2-0/+85
Added steps to build composite & discreet documentation in include-documentation. Added development in progress label atop index. Change-Id: I28526f157a09e10faf17307445c4d90a3903be03 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-02-08Documentation guide ported from wikiShubhamRathi2-1/+117
Edited content to enforce the new changes. Added label to include-documentation.rst file which is referenced from the documentation guide. Change-Id: I6e81288062716231ece5934a0be934ed0dbb60dc Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-02-03Merge "New docs for 'How to include documentation'"Sofia Wallin2-37/+98
2017-01-31Misc ChangesShubhamRathi11-32/+32
Renamed developer/ to development/ in templates. Corrected chapter level markup in docs/release/ Moved testing above developement in index Change-Id: I950f69bf2ac60e97b260ecfbb4b870a42f8a233b Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-31New docs for 'How to include documentation'ShubhamRathi2-37/+98
This documentation elucidates the revised procedure to include project documentation. Change-Id: Icfcab3a07e386453ae7faf9fa737fe726ff70f0c Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-30Merge "Moving design/ requirements/ to developer"Sofia Wallin4-2/+2
2017-01-30Changing Documentation ThemeShubhamRathi1-1/+1
Documentation theme changed from 'united' to 'journal' Change-Id: I89242a324ea3bd827f829b07f43098d91c225eb8 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-30Moving design/ requirements/ to developerShubhamRathi4-2/+2
design/ & requirements/ were erroneously placed under templates/release earlier. This patch fixes them to templates/developer. Change-Id: I1159c2999c63a4dd8f29e893fab9374e3077f59f Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-30Cleanup old templates and add placeholders where requiredShubhamRathi30-502/+5
Old templates have beem eliminated. Placeholder index file has been added for design/, release/ & testing/. Change-Id: I536929924de42c855b6e775a1f2391db4cd04fc1 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-26Removing RTD HackShubhamRathi2-8/+1
Eliminated rm -rf * from conf.py file & time, date of generation from index. Change-Id: I1c2c3da15a11b59659b9fbb46982bf71d7ec2ba9 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-25Merge "RTD Workaround to delete old files"Aric Gardner2-53/+61
2017-01-24Merge "Adding all templates under templates/"Sofia Wallin13-0/+676
2017-01-24Merge "Original 'Including your Documentation'"Sofia Wallin1-0/+66
2017-01-24Original 'Including your Documentation'ShubhamRathi1-0/+66
Moving all content out of the wiki, plan is to keep document build instructions in the opnfvdocs repo too. This file shall be edited with the new instruction. Change-Id: Ie2e441be1810182c101bd3819ddc6587e1c6b2c2 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-23Updated intro and vsperf project description.Trevor Cooper1-22/+22
Updates: Fixed review issues with trailing white spaces, Bottlenecks description and made further vsperf description edits. Change-Id: Id1c979f6365b022f27ab79ac7b75a42110e0150b Signed-off-by: Trevor Cooper <trevor.cooper@intel.com>
2017-01-22Adding all templates under templates/ShubhamRathi13-0/+676
Templates for docs contribution have been added under templates/ .Templates for release/ have been added only. Most of these templates have been made by resuing the structure and content of previous releases to reduce rework on part of project teams. Change-Id: I13f9b7fbb372bd712ee64aed775a2cede771f429 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-20RTD Workaround to delete old filesShubhamRathi2-53/+61
Workaround to delete old files in RTD: We are callling a subprocess from conf.py file to rm -rf *.The builds on RTD are failing but documentation is being updated nonetheless, to check - we are seeing the build time and date in index. Change-Id: I278490e322e97e263d90f568fe4331bcc40ff4ad Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-20Move Scenario under releaseShubhamRathi3-0/+0
Scenario templates moved under Release. Spelling for Integration corrected. Change-Id: I3016ad8226293f3c806563b747fb14a140afece1 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-19Update testing community docMorgan Richomme5-40/+339
Change-Id: I7ffbb3c0460958e3ecd837a14bf0c9a5752d1fc0 Signed-off-by: Morgan Richomme <morgan.richomme@orange.com>
2017-01-16Adjusted naming pathSofia Wallin26-0/+0
Adjusted the naming path for consistency throughout our repository and the community. Change-Id: Ia055c418584f338f6000835fc28a7e5e8b5c5818 Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2017-01-15Add Index page for Feature ProjectsShubhamRathi1-0/+156
This feature index page lists all feature projects. This is proposed to be added under 'Developer Documentation' Change-Id: I84f21000923d3b00c93cb8b2b4d00c15711d19e9 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-15Add index page for subrelease projectsShubhamRathi1-0/+34
Index page for subrelease projects. This is proposed to be added under 'Release documentation' Change-Id: I66d9b5977697a1512ee3491921652dbad589bd23 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-15Add new templates for docs contributionShubhamRathi26-0/+500
Adding new templates for docs contribution to be used by the project teams. Templates for 'Testing/' havent been added yet since its not perfectly clear what all cases need to be documented. Change-Id: Id9c1d0d87d99bb071cbcd493817500666cd59b79 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-14Add index with submodulesShubhamRathi1-28/+31
Index page updated to point to feature, testing and installer projects. This is in tandem with the plan to divide documentation in Release, Developer and Testing. Change-Id: I7e54190d402a6c241a358c9e13ce477d496f23a3 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-12Add conf.py, static filesShubhamRathi5-0/+278
Adding new conf.py & static files that shall be used to render docs. As part of the move to read the docs, intent is to have a single static conf.py at the root which shall manage the themeing etc. Change-Id: I71aedd1268649889e7e8c1e357fd3860f08ae390 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2017-01-11Add submodules and .gitmoduleShubhamRathi44-1/+1
Adding submodules of all OPNFV projects in order to create a unified repository for documentation. By using submodules we will be able to maintain a single conf.py file and theme to be used across all projects Change-Id: I65ec1a85f074f142bc335e8611e9636b5e4cb3a9 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
2016-11-24Adjusted the docs repo structure for D release workSofia Wallin52-924/+37
Change-Id: I9befe06c424c726e17d754bc480413b2430549ba Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-11-23New file for the readthedocs rendered.ChristopherPrice1-0/+10
This is a placeholder to test the toolchain. Change-Id: Ib3eb61632e812369e6da6706a7ff8fe20a43c547 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-11-15Merge "Add figure for Testing Ecosystem"Sofia Wallin2-1/+3
2016-10-25Colorado 2.0 updatesSofia Wallin4-127/+124
Updated according to comments All links updated for colorado 2.0 Link fixed in the overview doc according to Jira ticket DOCS-161 Change-Id: Ib3ff5f1159c45c6dc45601360e4e31a5210a15ec Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-09-23Last minute adding LXD scenario docsChristopherPrice1-0/+2
Change-Id: I530c2e01b03b49bfde4d4b10b353451c5d56fdbd Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-09-22Add figure for Testing EcosystemMorgan Richomme2-1/+3
Change-Id: I7f71ff607e281e8991821fc9543f787d809d6b19 Signed-off-by: Morgan Richomme <morgan.richomme@orange.com>
2016-09-22Final Colorado 1.0 update for the release documentation libraryChristopherPrice1-41/+104
Final version afaict Change-Id: Ib15662ff3608880efdac84b147b9815d58824610 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-09-22Final versionSofia Wallin3-7/+54
Fixed trailing whitespaces Added StorPerf, this should prob the last link to add. Adding more document links. Added security notes Added numbering to the user guide Adding the feature configuration parts to the user guide. Change-Id: I2b1569c97507be18bd0ec17fab41eeb2554726e5 Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-09-20Final version of the release document list.ChristopherPrice1-57/+46
Updated with all Colorado release links. Change-Id: Ia02b0add393a1af414d4c28a13e173a35077b134 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-09-19Draft of the overview doc.ChristopherPrice7-444/+291
Change-Id: I13d4230591055c5e8c1f4daa469a6bf71993856e Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-09-19WIP: Created 2 introduction documents for user guide and installationSofia Wallin27-1165/+148
Work on the contant in both installation and user guide Started to add artifacts in the installation instruction and user guide This is a first draft of the installation.introduction.rst and userguide.introduction.rst. Some of the information has been reused from the Brahmaputra docs with modifications. Please comment and add as needed/wanted. Change-Id: I0c6d79aac7d1152ec894986dda251ad2d3c7048e Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-09-15A compact version of the documentation library.ChristopherPrice1-0/+157
This document provides a master branch link to all Colorado related documentation. The patch to Stable will update all release links to /colorado/docs/ but for the time being this document should remaina accurate on master. Change-Id: I47feb62980311f6f76ddc44ef6e46a0999690a8f Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-09-01Adding creative commons license info.ChristopherPrice1-2/+0
Cannot build a reference until it's merged I guess, Ryota can you make sure this is not broken? Change-Id: Ibc7d98287cb513b894ae79f53864f654959de39a Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-08-24Merge "remove pfd/odt creation"Sofia Wallin1-43/+8
2016-08-19Created a template for feature configurationSofia Wallin1-0/+21
Updated according to comments. Any more information or steps neeeded please add. Change-Id: Ibd3685252f7ae0fe236f36ee640b3424f0761fb5 Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-08-11Creating a template for feature projects to produce userguide and scenario ↵ChristopherPrice4-0/+90
description documents This template will be pushed to features projects in Colorado to help them create the right documentation for the Colorado release. The documentation will be feature and scenario specific at a level where that makes sense while allowing common activities like instalation to be handled in documents for the installation tools. Change-Id: I649c583233ab8d8f8c3ebf7ddf8ae539dae15c8a Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-08-11remove pfd/odt creationRyota MIBU1-43/+8
This patch also adds description of html_sidebars in how-to doc. Change-Id: I904ceca3847a085754aacc8d0d0a388f2606c880 JIRA: DOCS-156 Co-Authored-By: Aric Gardner <agardner@linuxfoundation.org> Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-08-10use doc8 in virtualenvRyota MIBU1-0/+1
Change-Id: I58fd9e9382932ebc2521765bb665dcf0473d6a68 JIRA: DOCS-152 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-07-26Updating the scenario installation template based on comments.ChristopherPrice5-695/+33
Commets from https://gerrit.opnfv.org/gerrit/#/c/16837 adressed. Change-Id: I83a58c5ec6088805a8670bc7801351d33c6e5fa8 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
2016-07-25fix pre-hookRyota MIBU1-0/+8
- execute pre-hook after required python package installed - remove execution flag of docs/pre-hook.sh as it's unnecessary - add howto document regarding 'Hooks' Change-Id: Ib94888b018347ce8660d53db93dba3586c098948 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-07-22support pre-hook in docs-build.shRyota MIBU1-0/+112
Some projects need special pre steps before executing docs-build.sh . For instance, opnfvdocs needs to download other repos which will be composited. Also, apidoc creation is needed during docs build in yardstick. In order to support such cases, this patch introduces pre-hook in docs-build.sh that provides much flexibility to projects and simplifies job definition in releng. Change-Id: If9f26c490671ec0788dc48dd4fccb4513d0ca777 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-07-22improve configRyota MIBU1-3/+2
A developer was asked to copy all contents in the base config file in order to set all parameters properly, even if the change is partial. This patch improves this config by setting all default parameters based on users' custom config file, so that they can write parameters just which they want to change. Change-Id: Ide459c8e9f416b29b114a4bf2a432e8eae1f841e Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-07-22Modified the templates for the C releaseSofia Wallin8-31/+44
We are getting there.... Change-Id: I8cdf4b2a642a653b0eaa48acf8a7e46bf4a2f98d Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
2016-07-20Creating a template scenario installation file for Colorado.ChristopherPrice12-0/+1330
Aside from my likely copywright infringements, please review/comment. The basic idea is we create a "master" versions for each colorado installer then each scenario derives from the master files to produce their own. The template is intentionally modular for that purpose. Change-Id: Ic5ca72ece8eb462e6e6e7307d3cde32ea7760b23 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>