From cad2111129b57c9c14f5c6bc645286fdc5bf4a3c Mon Sep 17 00:00:00 2001 From: yanlong Date: Wed, 26 Jul 2023 15:12:04 +0800 Subject: [PATCH] docs:Improve the README of vpp docs Type:fix Change-Id: Ie2ae728450ef123379b697cdf9c873d5bec01b47 Signed-off-by: yanlong --- docs/README | 51 ++------------------------------------------------- 1 file changed, 2 insertions(+), 49 deletions(-) diff --git a/docs/README b/docs/README index 7e82709c876..97f09d103dc 100644 --- a/docs/README +++ b/docs/README @@ -1,49 +1,2 @@ - -Building VPP Documents - -These instructions show how the VPP documentation sources are built. - -To build your files, you can either Create a Virtual Environment using -virtualenv, which installs all the required applications for you. - -Create a Virtual Environment using virtualenv -============================ - -For more information on how to use the Python virtual environment check -out https://packaging.python.org/guides/installing-using-pip-and-virtualenv - -Get the Documents ------------------------------- - -For example start with a clone of the vpp. - -$ git clone https://gerrit.fd.io/r/vpp -$ cd vpp - -Install the virtual environment ----------------------------------------------- - -$ python -m pip install --user virtualenv -$ python -m virtualenv env -$ source env/bin/activate -$ pip install -r docs/etc/requirements.txt -$ cd docs - -Which installs all the required applications into it's own, isolated, -virtual environment, so as to not interfere with other builds that may -use different versions of software. - -Build the html files ----------------------------- - -Be sure you are in your vpp/docs directory, since that is where Sphinx will -look for your conf.py file, and build the documents into an index.html file - -$ make html - -View the results ------------------------- - -If there are no errors during the build process, you should now have an -index.html file in your vpp/docs/_build/html directory, which you can -then view in your browser. +If you want to build a VPP documentation source, please refer to the VPP user documentation: +https://fd.io/docs/vpp/master/contributing/writingdocs.html -- 2.16.6