matrix-spec-proposals

Commit Graph

Author	SHA1	Message	Date
Kegan Dougal	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
Kegsay	c96f02c2b0	Merge pull request #69 from matrix-org/erikj/login_token m.login.token	9 years ago
Erik Johnston	6e6bc8a5a9	Mandate macaroon	9 years ago
Erik Johnston	ce53a17180	Add txn_id rationale	9 years ago
Kegan Dougal	5abea1f2bc	Minor tweaks	9 years ago
Kegan Dougal	70518ae655	Clarify template suffixes	9 years ago
Kegan Dougal	643468e914	Mention swagger. Clarify how event type template vars are formed.	9 years ago
Kegan Dougal	c2fc1a2fb1	Add basic module template. This has the core sections for events/server/client/security.	9 years ago
Erik Johnston	97154cc6b2	s/nonce/txn_id/	9 years ago
Erik Johnston	4c9f524cab	Neaten things up	9 years ago
Erik Johnston	317c2f20d3	Draft login token spec	9 years ago
Kegan Dougal	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
Kegan Dougal	29bae15790	Fix typo	9 years ago
Kegan Dougal	5115346297	Add instant_messaging module; modify batesian section rules Previously, all `m.room.*` events were wodged into `{{room_events}}` which isn't great when you want to pull specific ones out. Batesian had a 1:1 mapping of `render_foo()` to a section `{{foo}}`, and having to constantly add functions for new types is a PITA. Batesian now supports returning a `dict` instead of a section `string` where the keys are the `{{foo}}` and the value is what will be inserted. Also add conflicting section key checks to avoid multiple definitions of the same `{{foo}}`. Define dicts for event schemata and swagger HTTP APIs. Using this new feature, split out the instant messaging stuff from the events section, and replace `{{room_events}}` with a list of specific events e.g. `{{m_room_member_event}}`.	9 years ago
Kegan Dougal	5b134119bd	Add presence module; fix relative title bug If a relative title appeared after an HTTP API table, it would insert the wrong level because it thought that part of the table was a title.	9 years ago
Kegan Dougal	b49cb57fe5	Move events sections to CS API	9 years ago
Kegan Dougal	16693a644a	Various review fixes	9 years ago
Kegan Dougal	b0eb985523	Merge branch 'master' into spec-restructure-modules	9 years ago
Kegan Dougal	0c0ac3e814	Fix common event fields template to use subtitle char	9 years ago
Kegan Dougal	e8cdfcbba2	Rename spec files to not have numbers everywhere; update targets.yaml	9 years ago
Kegan Dougal	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
Kegan Dougal	067363c629	Get the desired title levels right; print out the actual level used to stdout	9 years ago
Kegan Dougal	8590cc84b5	Process and extract targets in gendoc.py	9 years ago
Kegan Dougal	568982ee2e	Represent nested deps in targets.yaml along with title styles This will allow us to programatically position .rst snippets anywhere which will for once and for all remove the horrid title level mismatch bugs. We require this in order to allow people to re-shuffle the spec without having to adjust the spec itself (e.g. 2 targets with different levels of nesting).	9 years ago
Kegan Dougal	703f913a47	Add a 'targets.yaml' files in /specification We're well beyond the point now where a simple `cat` of .rst files to "build" the spec is practical. We may want to slice and dice the spec in different ways to address various cross-cutting concerns. To this end, there is now a 'targets' file which contains the "build targets" for the spec, which contains the sorting order for the .rst files. For now, we just have a single target: 'main'.	9 years ago
Kegan Dougal	f520ac9d82	Create a modules folder to group together similar parts of the spec	9 years ago
Kegan Dougal	c77ef1a2cc	Add stub files feature_profiles and modules	9 years ago
Kegan Dougal	f2c952ec58	Reshuffle spec into sections roughly right as per PR #52	9 years ago
Mark Haines	f33c0846c3	Merge remote-tracking branch 'origin/master' into markjh/document_v1_rooms_api	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	9ed39665c8	PR feedback	9 years ago
Kegan Dougal	8e7b33ac99	Fix more typos/spelling errors	9 years ago
Kegan Dougal	3f9d183c2a	More typo/layout fixes Split out identity servers to a separate file	9 years ago
Kegan Dougal	620d3dcb26	Test commit	9 years ago
Kegan Dougal	faa95e172f	More formatting fixes; typos; etc	9 years ago
Kegan Dougal	af32ec194a	Move VoIP events to 22_voip_events 20_events is a huge as it is, this makes it easier to find what section you actually want when editing.	9 years ago
Kegan Dougal	5b59c67510	Minor formatting fixes. Fix state event templating.	9 years ago
Mark Haines	7eb8b4fde2	Add new-style docs for the APIs for getting events for a room	9 years ago
Daniel Wagner-Hall	59a4e84361	s/registration/login/	9 years ago
Daniel Wagner-Hall	b8e2ac5c1b	Swaggerify /login	9 years ago
Kegsay	e788f565f8	Merge pull request #36 from matrix-org/daniel/threepidinvites Swagger /room/{roomId}/invite	9 years ago
Kegsay	3011823c51	Merge pull request #27 from matrix-org/receipts Document receipts	9 years ago
Daniel Wagner-Hall	2797fac3aa	Swagger /room/{roomId}/invite This is a transcription of the current spec, with nothing new or controversial in it.	9 years ago
Daniel Wagner-Hall	04b2b2588f	Fix up formatting and typos	9 years ago
Daniel Wagner-Hall	d53943c8c2	Spec /room/{roomId}/join This is just replacing the existing spec with a swagger version. Subsequent pull requests will add 3pid join to this, as well as specing the invite, leave, ban, and kick endpoints.	9 years ago
Erik Johnston	80bb51d9bb	Make it clearer	9 years ago
Erik Johnston	4b24b887c7	Document m.room.history_visibility	9 years ago
Erik Johnston	83dfc2bf61	Fix some mistakes/typos	9 years ago
Erik Johnston	0dc22e7217	Document receipts	9 years ago
Paul "LeoNerd" Evans	49c52a96a7	Rename 'perspective server' to 'notary server' as that's what the Perspectives Project calls them too	9 years ago

1 2 3

145 Commits (a49d5f67f1ee8e06c2c7a3e0baaba5f120f7a4e3)