Add deprecation notice
[web.git] / README
1 This is the repository of the old LEDE web presence.
2
3 The files in here mostly serve historical interest, the actual web
4 presence is maintained in the wiki nowadays.
5
6 --
7
8 This is the repository of the LEDE web pages.
9
10 All pages should follow these rules
11
12 * written using asciidoc
13 * changes are verified using aspell
14 * changes to the rules.txt files are not allowed without a prior vote
15
16 Top level pages are located in this directory while the "Documentation"
17 can be found in the docs/ sub-folder.
18
19 The _includes/ folder contains the html structure of the site navbars,
20 if you add a page please add it in the respective nav bar so that it
21 becomes reachable.
22
23 The website is generated from asciidoc using jekyll invoked by a cron script
24 every 15 minutes.
25
26 If sources are updated to require new jekyll plugins or a changed configuration
27 then tell someone with access to the web server so that the settings can be
28 synchronized with those in the tree.
29
30 In order to generate the pages locally for testing your changes,
31 install https://jekyllrb.com/, issue "jekyll serve" and navigate to
32 http://127.0.0.1:4000/ with your browser.
33
34 LICENSE is TBD and should be placed in the LICENSE file once decided.
35