e045f28b44
Pull out constant for permissions
...
Also, drop permissions from 0755 to 0700
9 years ago
24356d864e
Merge pull request #176 from matrix-org/daniel/gendoc
...
Tweaks to spec generation for matrix.org
9 years ago
4ac85997f5
Fix check
9 years ago
da93317a78
Take dir not files as args
9 years ago
ca3a9e3562
exec gendoc outside of script
9 years ago
e041033048
Rename file
9 years ago
8586744771
Add anchors to spec
...
This is currently done by a script on the prod serving machine.
We might as well keep the matrix.org spec and dev spec as similar as
possible.
9 years ago
6f1d00097b
Only bother trying to fetch if we need to
9 years ago
8872e17f93
Fall back to last known HEAD sha if fetch fails
9 years ago
dd53847211
Include command stderr in error text
9 years ago
9ad64b02d1
speculator: guard against concurrent git commands
9 years ago
0f0359d9c1
speculator: Nessle up some more if statements
9 years ago
740cc66a7c
speculator: Fetch before deciding head is fresh
9 years ago
27ffe7bacd
Don't serve rst diffs as HTML
9 years ago
c3608b3a69
Merge branch 'master' into daniel/continuservconcurrency
...
Conflicts:
scripts/continuserv/main.go
9 years ago
bbf9e229a7
continuserv: guard concurrent accesses to wg
9 years ago
1be5b856bd
Preserve text/plain for errors
...
Newlines are nice
9 years ago
7f6eafdce5
continuserv: set Content-Type header
9 years ago
937ff046d8
Force / to be HTML too
9 years ago
559747e77a
speculator: Sent Content-Type: text/html header
...
Go is auto-detecting that this is XML (because for some reason we
generate XHTML), and serving it with a Content-Type header text/xml.
This causes the browser to render it as XHTML, which gives interesting
quirks like extra newlines.
This forces the browser to interpret it as HTML.
What we should probably do instead of stop generating XHTML and start
generating HTML. But in the mean time, this will fix the rendering
issues.
9 years ago
71874870c8
Enable syntax highlighting for example http requests
9 years ago
1aeddac319
Cache spec output
...
Does not cache inability to generate spec. Does not cache diffs or
anything fancy. Just the raw spec generation.
9 years ago
df443c10ac
Move css into a css subdirectory.
...
Add css to put a bar next to blockquotes.
9 years ago
82d4ea199f
Trust Leo
9 years ago
e5559e4ea5
Merge pull request #106 from matrix-org/erikj/newline_gendoc_STOP_BEING_CRANKY
...
gendoc should just add newlines rather than complaining about the lack thereof
9 years ago
70704240dc
gendoc should just add newlines rather than complaining about the lack thereof
9 years ago
013b6db895
Add a note on building the speculator
...
... because the wiki says you need to read the README on how to build it.
9 years ago
270e1d7aa8
Add richvdh to list of trusted pushers for spectulator
...
richvdh is awesome, he should have all the permissions.
9 years ago
1cfe4f784f
special css for spec/howto
9 years ago
ceebf34fca
generate docs with new nav bar
9 years ago
6922850643
Add missing return
9 years ago
b46f0e30b8
Checkout SHA of origin/master rather than merging
9 years ago
a0cf485919
speculator: Specify merge target
9 years ago
7805ca87df
If build.py throws, actually print stdout. Also run jenkins.sh in verbose mode.
9 years ago
8c092e3d11
Merge pull request #74 from matrix-org/module-presence
...
Presence module
9 years ago
7df3d9090a
Merge pull request #81 from matrix-org/daniel/speculatormerge
...
speculator: Merge after fetching, so that /spec/head works
9 years ago
0e8f1b5475
Quote args
9 years ago
a69e03f577
speculator: Report listening port
9 years ago
30232f20aa
speculator: Merge after fetching, so that /spec/head works
9 years ago
cc6f256b24
Merge branch 'master' into module-presence
...
Conflicts:
specification/modules/presence.rst
9 years ago
f74cb4d54c
Merge pull request #76 from matrix-org/speculator-speedup
...
Modify how speculator uses git repos
9 years ago
b6f0b67da6
Speed up continuserv
...
Ignore .git directory as that shouldn't affect spec generation. Also, when
we receive writes from the OS, wait a bit before re-generating the spec to
clump together multiple writes rather than re-generating one after another
and waiting for no more writes before serving the request.
9 years ago
ede43fbe9f
Modify how speculator uses git repos
...
Modified so it has a "master" repo and local A/B repos which pull from the
"master". This saves an extra git clone operation per HTTP request.
9 years ago
52f6496cf0
Merge branch 'master' into module-presence
9 years ago
a49d5f67f1
Delete rather than comment out the offending CSS
9 years ago
4e1e82f995
Fix paragraph CSS and adjust where paragraphs are in the RST
...
The CSS for `nature.css` was such that it was preventing `p` tags from
having sufficient vertical whitespace. This meant that you couldn't insert
any kind of spacing between lengthy sections (they just appeared as new lines).
This PR fixes this so you can actually have some whitespace between paragraphs.
As a result of this change, some parts of the spec appeared to have too much
whitespace. These were often sections which shouldn't have begun a new
paragraph anyway (e.g. a single sentence being an entire paragraph, `TODO`
blocks resulting in new paragraphs). This PR fixes the most offending areas
where we shouldn't have been inserting new paragraphs.
9 years ago
0a04672d76
Start converting the presence module. Add Rationale admonition.
9 years ago
083a76096f
Support viewing the spec at head
9 years ago
2434dfaf1c
Merge branch 'master' into speculator-htmldiff
9 years ago
6afdfc0771
Add more logging and make logging context clearer
...
This is now actually useful if you want to debug why your swagger YAML
isn't producing a table you think it should be.
9 years ago
f1adad5fb3
Add more logging with file prefixes
...
This makes the handoff between gendoc and batesian clearer in the logs.
9 years ago
064a2c9172
Use argparse and log functions for gendoc.py
...
gendoc.py has become more complex such that we actually want to pass things
to it like `--verbose`, `--nodelete`, `--target`, so use `argparse` to do this
like we have `build.py`. Pass through `-v` flags to `build.py`.
9 years ago
1da64db302
Use relative depths for groups instead of absolute ones
...
This means the group can be agnostic to how deeply nested it is,
improving reusability of groups.
9 years ago
16693a644a
Various review fixes
9 years ago
b21859836d
Print stdout of build.py in verbose mode
9 years ago
f71763b0d3
Implement relative title styles
...
Templates don't know at what level they will be inserted. Previously, we
hard-coded the title style which is not compatible with the build target
system. Define a set of styles which will be replaced by the gendoc script
when it encounters them:
'<' : Make this title a sub-heading
'/' : Make this title a heading at the same level
'>' : Make this title a super-heading
The build target system is now basically complete and functioning.
9 years ago
067363c629
Get the desired title levels right; print out the actual level used to stdout
9 years ago
d5e0115e42
Merge branch 'master' into spec-restructure-modules
9 years ago
65ce95249f
cat the spec according to the build target. Remove old checks as they are now obsolete since we don't care about the filename
9 years ago
8590cc84b5
Process and extract targets in gendoc.py
9 years ago
6b5b8432b3
Turn on code highlighting for HTTP api responses and add a
...
code highlighting stylesheet for the specification.
9 years ago
5fbd534713
Merge pull request #51 from matrix-org/daniel/gendoc
...
Print errors to stderr
9 years ago
cf8abdafd4
Fix PR comments
9 years ago
ba4998a62b
Apparently tabs are A Thing
9 years ago
427e4c8b1b
Log port being listened on
9 years ago
1f6b12b3e8
Modify and enforce the file format/structure used
...
Convert the file format to be of the form ##_##_something.rst where the
first ## is the top-level section number and the second ## is the
second-level section number, e.g. 07_01_push_cs_api.rst means
Section 7.1 - This is now enforced in gendoc.py along with the title line
style that should be used (= for top-level, - for 2nd level) which will
give helpful suggestions if you trip up. This feels much more intuitive
now looking in /specification
9 years ago
06e46c1899
Fix on a better numbering format
9 years ago
ef473b4161
Start enforcing title styles
...
This depends on the number of the file.
9 years ago
08defafd98
Print errors to stderr
...
This means that continuserv will actually display them
9 years ago
ad26b7f8cb
Fix a subtle rendering bug when catting spec sections
...
Throw in gendoc.py if a spec section doesn't end with \n\n
There needs to be TWO new lines at the end of each spec section else the
title of the next section merges into the last paragraph of the earlier
section. This happens without rst2html producing a warning, and results
in the section heading of a file disappearing(!)
9 years ago
9c3a333a6d
Apparently tabs are A Thing
9 years ago
9b18fd252e
Log port being listened on
9 years ago
21411309e0
Fix chdir path
9 years ago
c3eab1cc3c
Set the current working directory in gendoc.py to the script directory as that is where it expects to be run
9 years ago
c55917d99c
Add spec diff to index page
9 years ago
521d625aac
Fix typo
9 years ago
d9013cab5f
speculator: Add HTML diffing
...
I started fiddling with re-implementing the perl script in Go to add
some new functionality (and avoid the Perl), but it's not yet usable
9 years ago
d251f791fb
speculator: Document /
9 years ago
f9ef934625
Merge branch 'master' into speculator-list
...
Conflicts:
scripts/speculator/main.go
9 years ago
e4f4670260
Merge pull request #44 from matrix-org/speculator-errs
...
speculator: Don't ignore errors
9 years ago
b6dab0009d
speculator: Don't ignore errors
9 years ago
20f0284155
speculator: Unified diff for rst diff
9 years ago
ba780a589a
speculator: Add list-pull-request functionality
9 years ago
fef97802b7
Merge pull request #39 from matrix-org/speculator
...
speculator: Tool to preview spec pull requests
9 years ago
bf318ffcd5
Add HTTP endpoints to README
9 years ago
ca7dd49dc6
speculator: Add /healthz endpoint
9 years ago
708f281270
Add comments about auth
9 years ago
c427c579cb
Merge pull request #37 from matrix-org/continuserv
...
continuserv: Server to live serve local updates to the spec
9 years ago
c29aef362e
Error on failure of Watcher.Add
9 years ago
6ac519d9dc
Log on file updates
9 years ago
6e86cb34d2
continuserv: Adding README
9 years ago
34091038f3
speculator: Tool to preview spec pull requests
...
Not the prettiest thing in the world, and horribly unperformant, but
useful :)
9 years ago
cdc06a8bf1
Document --nodelete
9 years ago
a74fb54053
Correct comment
9 years ago
ad595aea45
Optionally don't delete intermediate rst files
...
Useful for debugging
Hackily hackily implemented :)
9 years ago
e30272733b
continuserv: Make port flag-specified
9 years ago
c4acee3bcb
continuserv: Live serves updates to the spec
9 years ago
0414ff4cc3
Output error if command fails
9 years ago
e572cc662a
Restructure the first few sections.
...
Remove unecessary sections; put presnece/profile sections on the right level.
Move Living Standard warning to the top of the Introduction section.
10 years ago
bb9537b824
Add a CHANGELOG. Modify table CSS.
...
Hook up templating system to read the CHANGELOG for version and changelog info.
Modified nature.css to make it clearer on table headings/sub-headings. Use the
full _matrix/client path on title links to make it clear it is for v1.
10 years ago
Daniel Wagner-Hall