Kegan Dougal
d5e0115e42
Merge branch 'master' into spec-restructure-modules
9 years ago
Kegan Dougal
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
Kegan Dougal
8590cc84b5
Process and extract targets in gendoc.py
9 years ago
Mark Haines
6b5b8432b3
Turn on code highlighting for HTTP api responses and add a
...
code highlighting stylesheet for the specification.
9 years ago
Kegsay
5fbd534713
Merge pull request #51 from matrix-org/daniel/gendoc
...
Print errors to stderr
9 years ago
Kegan Dougal
cf8abdafd4
Fix PR comments
9 years ago
Kegan Dougal
ba4998a62b
Apparently tabs are A Thing
9 years ago
Kegan Dougal
427e4c8b1b
Log port being listened on
9 years ago
Kegan Dougal
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
Kegan Dougal
06e46c1899
Fix on a better numbering format
9 years ago
Kegan Dougal
ef473b4161
Start enforcing title styles
...
This depends on the number of the file.
9 years ago
Daniel Wagner-Hall
08defafd98
Print errors to stderr
...
This means that continuserv will actually display them
9 years ago
Kegan Dougal
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
Kegan Dougal
9c3a333a6d
Apparently tabs are A Thing
9 years ago
Kegan Dougal
9b18fd252e
Log port being listened on
9 years ago
Daniel Wagner-Hall
21411309e0
Fix chdir path
9 years ago
Mark Haines
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
Daniel Wagner-Hall
c55917d99c
Add spec diff to index page
9 years ago
Daniel Wagner-Hall
521d625aac
Fix typo
9 years ago
Daniel Wagner-Hall
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
Daniel Wagner-Hall
d251f791fb
speculator: Document /
9 years ago
Daniel Wagner-Hall
f9ef934625
Merge branch 'master' into speculator-list
...
Conflicts:
scripts/speculator/main.go
9 years ago
Kegsay
e4f4670260
Merge pull request #44 from matrix-org/speculator-errs
...
speculator: Don't ignore errors
9 years ago
Daniel Wagner-Hall
b6dab0009d
speculator: Don't ignore errors
9 years ago
Daniel Wagner-Hall
20f0284155
speculator: Unified diff for rst diff
9 years ago
Daniel Wagner-Hall
ba780a589a
speculator: Add list-pull-request functionality
9 years ago
Daniel Wagner-Hall
fef97802b7
Merge pull request #39 from matrix-org/speculator
...
speculator: Tool to preview spec pull requests
9 years ago
Daniel Wagner-Hall
bf318ffcd5
Add HTTP endpoints to README
9 years ago
Daniel Wagner-Hall
ca7dd49dc6
speculator: Add /healthz endpoint
9 years ago
Daniel Wagner-Hall
708f281270
Add comments about auth
9 years ago
Kegsay
c427c579cb
Merge pull request #37 from matrix-org/continuserv
...
continuserv: Server to live serve local updates to the spec
9 years ago
Daniel Wagner-Hall
c29aef362e
Error on failure of Watcher.Add
9 years ago
Daniel Wagner-Hall
6ac519d9dc
Log on file updates
9 years ago
Daniel Wagner-Hall
6e86cb34d2
continuserv: Adding README
9 years ago
Daniel Wagner-Hall
34091038f3
speculator: Tool to preview spec pull requests
...
Not the prettiest thing in the world, and horribly unperformant, but
useful :)
9 years ago
Daniel Wagner-Hall
cdc06a8bf1
Document --nodelete
9 years ago
Daniel Wagner-Hall
a74fb54053
Correct comment
9 years ago
Daniel Wagner-Hall
ad595aea45
Optionally don't delete intermediate rst files
...
Useful for debugging
Hackily hackily implemented :)
9 years ago
Daniel Wagner-Hall
e30272733b
continuserv: Make port flag-specified
9 years ago
Daniel Wagner-Hall
c4acee3bcb
continuserv: Live serves updates to the spec
9 years ago
Daniel Wagner-Hall
0414ff4cc3
Output error if command fails
9 years ago
Kegan Dougal
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.
9 years ago
Kegan Dougal
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.
9 years ago
Kegan Dougal
f9710a6e17
Add help blurb to gendoc.py
9 years ago
Kegan Dougal
5b31c442f5
Completely split up the templating system from the Matrix Spec template code.
...
The two are now linked together in build.py by specifying the input module.
Updated gendoc.py to specify the right module.
9 years ago
Kegan Dougal
96671ce833
Use the templating system to set {{git_version}}. Restructure sections code.
...
Restructured the sections code to be slightly more encapsulated than before.
This will be expanded to more clearly separate the templating system from
the specific implementation of the spec templates.
9 years ago
Kegan Dougal
dc5c01607b
Sort out table layout and rejig where state_key is placed.
9 years ago
Kegan Dougal
02c44a889e
Remove stuff from 20_events.rst and replace with {{room_events}}. Update gendoc to call build.py for template vars.
9 years ago
Matthew Hodgson
d40f6c1d7c
lots of fixes based on kegan's review of https://github.com/matrix-org/matrix-doc/pull/13
10 years ago
Matthew Hodgson
598e9b3113
big reshuffle:
...
* try to make 00_basis slightly more accessible and less terse
* move CS API before Events, as it's meaningless to dive into specific events if you haven't been introduced to how the CS API works
* Try to improve the beginning of the CS API by merging back in some of kegan's original v1 content (which has subsequently been deleted somewhere along the line?)
* document m.presence event consistently
* move typing from drafts to spec
* move push stuff from drafts to spec
...and lots of other stuff
move push & typing from drafts into main spec.
10 years ago
Kegan Dougal
a6fa4e53fb
Update gendoc.py
...
Copy howto to tmp/ so the $GIT_VERSION can be dropped in.
10 years ago
Kegan Dougal
505c804426
Update scripts to look in the right places. Update jsfiddles to be more obvious in the HOWTO.
10 years ago
Kegsay
6af1627b51
Minor tweak for matrix.org example
10 years ago
Kegan Dougal
1388612c48
Add a README, spell matrix correctly.
10 years ago
Kegan Dougal
4b0e858529
Add $GIT_VERSION to the spec which is replaced by the gendoc script.
10 years ago
Kegan Dougal
df448df813
Redo gendoc script.
10 years ago
Matthew Hodgson
3c16dbd63b
it's 2015
10 years ago
Matthew Hodgson
9de59e3777
move gendoc to matrix-doc and make it work. rename tutorials section to match matrix.org structure
10 years ago