wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
1602 commits 4 branches 0 tags 17 MiB
Commit graph

154 commits

Author SHA1 Message Date
Richard van der Hoff
f46a2a7f2b Include the basePath in the path in swagger output 
This fixes both SPEC-393, and ORG-52.
 2016-05-06 12:35:27 +01:00
Richard van der Hoff
8aa0f64665 Update the speculator to understand spec subdirs 
Fix the speculator so that it doesn't blow up when it finds subdirs in the gen
directory.

(It doesn't handle the html diff very well in the case that the subdirs don't
match, but it's hard to do much about that)
 2016-05-05 18:46:29 +01:00
Richard van der Hoff
01f8173c84 Put each bit of spec in its own directory 
I want to change the URLs for the spec sections on the website from
<version>/<section>.html to <section>/<version>.html, to better reflect how we
do the versioning.

This puts each bit of spec in its own directory, updates the index to point to
the right place, and fixes continuserv to deal with directories as well as
files.

This will probably require fixes to the speculator too, but I'll have to come
back to that.
 2016-05-05 18:26:17 +01:00
Richard van der Hoff
a8eed29e9f gendoc: Allow multiple targets 2016-05-05 16:49:10 +01:00
Richard van der Hoff
7138205f31 Update README.md 
escape angle-bracket to stop it getting lost in markdown
 2016-05-04 01:08:50 +01:00
Richard van der Hoff
0546f0917d Replace hacky shell to do matrix styling with hacky perl 
Since the shell just wrapped three invocations of perl, we might as well do
it all in perl.
 2016-05-04 00:01:54 +01:00
Richard van der Hoff
23c4ffbc1b Add securityDefintions to generated swagger JSON 
Also factor out to a common file
 2016-05-03 13:57:16 +01:00
Richard van der Hoff
60f36bf868 Script to serve the generated swagger JSON 
We need custom CORS headers to serve the swagger JSON, so add a script to do it
 2016-05-03 12:04:44 +01:00
Richard van der Hoff
c39d797cce Dump-swagger: take output file name rather than output dir 
Make the argument to dump-swagger.py be the name of the output file rather than
the output dir, and give it a sensible default.

Also, use the absolute path to the output file, so that the output path is
relative to the user's cwd rather than the templating dir.
 2016-05-03 12:03:21 +01:00
Richard van der Hoff
d6c1d1343b Continuserv: Reduce number of watches 
rather than trying to watch half the filesystem, be a bit more conservative in
what we put watches on. This means that we don't end up dying with "No space on
device" (thanks for that, Linux.)
 2016-04-11 23:21:21 +01:00
Daniel Wagner-Hall
072d285153 speculator: Allow access token to be specified 2016-02-15 14:48:26 +00:00
Richard van der Hoff
1f6c4d5bb2 Speed up gendoc.py by only running build.py once 2016-01-08 00:40:03 +00:00
Daniel Wagner-Hall
aaeaa1dd98 Detect major version in presence of patch release 2015-12-09 15:56:58 +00:00
Daniel Wagner-Hall
ad7874a730 Use site-relative stylesheet 2015-12-09 14:35:25 +00:00
Daniel Wagner-Hall
60127de1e3 Take list of files to edit as args 2015-12-09 13:50:15 +00:00
Daniel Wagner-Hall
a9b4f6fef0 Add missing _ to paths 2015-12-08 15:39:32 +00:00
Daniel Wagner-Hall
db5cad4711 Remove accidentally committed change 2015-12-07 15:16:06 +00:00
Daniel Wagner-Hall
99b8a066c8 Make dump-swagger work from all directories 2015-12-07 14:40:42 +00:00
Daniel Wagner-Hall
1f5b6271f2 Generate swagger-ui output for client-server API 
Depends on:
https://github.com/matrix-org/matrix-doc/pull/212
https://github.com/matrix-org/matrix-doc/pull/208
https://github.com/matrix-org/matrix-doc/pull/207
for the actual rendered output to not throw javascript errors at runtime.
 2015-12-07 12:45:13 +00:00
Richard van der Hoff
d1d3d27e2f Merge pull request #216 from matrix-org/rav/fix_speculator_redirects 
Add a host and scheme to Location headers in redirects
 2015-12-07 10:26:38 +00:00
Richard van der Hoff
f31a053995 Add a host and scheme to Location headers in redirects 
Our apache reverse-proxy can't correctly rewrite relative Location headers, so
add the Host from the request into the Location.
 2015-12-06 18:26:56 +00:00
Matthew Hodgson
78e04d662e add moi :( 2015-12-04 18:32:01 +00:00
Richard van der Hoff
1b7548d460 Make the speculator serve the spec from drafts branches. 2015-12-04 17:03:33 +00:00
Daniel Wagner-Hall
2f3a00fe34 Consistently spell homeserver as homeserver 2015-12-02 19:23:33 +00:00
Daniel Wagner-Hall
1ce3357927 continuserv: serve multiple paths 2015-12-02 14:57:28 +00:00
Daniel Wagner-Hall
97fd1fdd62 Embed client and server release numbers 
Note that this also removes the changelog - I'm going to re-add the
changelog differently soon.
 2015-12-01 17:08:02 +00:00
Daniel Wagner-Hall
ebed3b60bd Add trailing slashes to links 2015-12-01 15:58:15 +00:00
Daniel Wagner-Hall
a4668c1d8c Fix typo 2015-12-01 14:21:20 +00:00
Daniel Wagner-Hall
c4eaf7458f 302 to spec/head/index.html rather than serving it on /spec/head 
Otherwise relative links are broken
 2015-12-01 14:19:31 +00:00
Daniel Wagner-Hall
6c66bfc755 Flatten out v1 and v2_alpha directories 
As a side effect, I got rid of all of the horrible symlinks and just put
in all of the proper relative paths. Because the horrible symlinks were
horrible.
 2015-11-30 11:22:57 +00:00
Daniel Wagner-Hall
e401d3e262 Merge pull request #184 from matrix-org/daniel/splitspec 
Split spec into page-per-section
 2015-11-27 16:46:06 +00:00
Daniel Wagner-Hall
30ed918633 speculator: Allow spec viewing for multi-page spec 2015-11-27 16:45:53 +00:00
Daniel Wagner-Hall
e171acf01f Split spec into page-per-section 2015-11-27 16:45:47 +00:00
Daniel Wagner-Hall
f0c99a6925 Generate API docs from swagger 2015-11-27 15:03:22 +00:00
Richard van der Hoff
2aa4773cc1 Make the speculator serve up errors as plain text 
... so that they are legible.
 2015-11-27 12:01:03 +00:00
Daniel Wagner-Hall
ec31c0f518 speculator: allow styling like matrix.org 2015-11-26 12:04:37 +00:00
Daniel Wagner-Hall
cc4869e68a Merge pull request #174 from matrix-org/daniel/speculatorhardening 
Several improvements to speculator to prepare it for actually being used by the masses, not just us devs
 2015-11-23 18:35:55 +00:00
Daniel Wagner-Hall
c432396079 Add comment 2015-11-23 17:26:32 +00:00
Daniel Wagner-Hall
866fa58276 Rename 2015-11-23 17:22:53 +00:00
Daniel Wagner-Hall
e045f28b44 Pull out constant for permissions 
Also, drop permissions from 0755 to 0700
 2015-11-23 17:20:54 +00:00
Oddvar Lovaas
24356d864e Merge pull request #176 from matrix-org/daniel/gendoc 
Tweaks to spec generation for matrix.org
 2015-11-23 10:28:51 +00:00
Daniel Wagner-Hall
4ac85997f5 Fix check 2015-11-19 18:16:02 -05:00
Daniel Wagner-Hall
da93317a78 Take dir not files as args 2015-11-19 18:13:40 -05:00
Daniel Wagner-Hall
ca3a9e3562 exec gendoc outside of script 2015-11-19 17:38:54 -05:00
Daniel Wagner-Hall
e041033048 Rename file 2015-11-19 17:38:49 -05:00
Daniel Wagner-Hall
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.
 2015-11-19 16:41:58 -05:00
Daniel Wagner-Hall
6f1d00097b Only bother trying to fetch if we need to 2015-11-19 16:15:13 -05:00
Daniel Wagner-Hall
8872e17f93 Fall back to last known HEAD sha if fetch fails 2015-11-19 16:14:22 -05:00
Daniel Wagner-Hall
dd53847211 Include command stderr in error text 2015-11-19 16:11:19 -05:00
Daniel Wagner-Hall
9ad64b02d1 speculator: guard against concurrent git commands 2015-11-19 15:41:15 -05:00