Mike Gerwitz

Activist for User Freedom

aboutsummaryrefslogtreecommitdiffstats
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* doc/hacking.texi (TypeScript Migration): .d.ts referenceMike Gerwitz2019-10-241-7/+10
| | | | | The original suggestion for interfaces (see diff) is much more confusing. We've found .d.ts files to work well for incremental migration.
* doc/hacking.texi (Nominal Typing)[isPositiveInteger]: Fix arg nameMike Gerwitz2019-10-241-1/+1
|
* doc/server.text (Server-Side DataAPI): Mention request supercedingMike Gerwitz2019-10-181-0/+3
|
* doc/hacking.texi (Typescript Migration): New sectionMike Gerwitz2019-10-181-0/+188
|
* server: Correct liza_timestamp_initial_rated to be a vectorMike Gerwitz2019-02-071-1/+9
| | | | | | | | | | | | The metabucket expects vectors, not scalars. This causes the value to be inaccessible when loaded by the ProcessManager for rating, because it uses the Bucket implementation expecting vectors. This wasn't noticed at first because it works through TAME's map. * doc/bucket.texi (Metabucket): Clarify expected data format. * src/server/db/MongoServerDao.js (saveQuote): Store `meta.liza_timestamp_initial_rated' as a vector.
* server: Auto-populate liza_timestamp_initial_rated in metabucketMike Gerwitz2019-02-051-0/+30
| | | | | | | | | | | | This value already existed on the document, but was inaccessible to external systems. This is now accessible to e.g. raters. * doc/bucket.texi (Metabucket): New section. * src/server/db/MongoServerDao.js (saveQuote): Set initial quoted date as liza_timestamp_initial_rated. Update metabucket keys individually so as not to inadvertently overwrite the entire metabucket. DEV-3715
* doc/program.texi: Document accordion groupMike Gerwitz2019-01-211-0/+11
| | | | * doc/program.texi (Group Styles): Add `accordion'.
* doc: Source files and developer resourcesMike Gerwitz2018-05-042-2/+189
| | | | | | | * doc/hacking.texi: Added new sections to menu. (Source Files): New section. (Developer Resources): New section. * doc/macros.texi (mocha,chai,easejs,gplv3): New macros for common links.
* doc: Macros for common library referencesMike Gerwitz2018-05-042-8/+19
| | | | | * doc/hacking.texi (Hacking): Use mocha, chai, easejs macros. * doc/macros.texi (mocha, chai, easejs): New macros.
* doc: Add information on JS libraries usedMike Gerwitz2018-05-043-3/+112
| | | | | * doc/hacking.texi: New file with information on libraries. * doc/liza.texi: Include it. Add to menu.
* client: Truncate diff posted to server after first nullMike Gerwitz2018-03-071-0/+42
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Before this change, since `undefined' is encoded as `null' when serialized, there was no way for the server to disambiguate between unmodified values and a truncation point. For example: [ undefined, undefined, null, null, null ] The above array represents two unmodified and three removed indexes. But this is serialzed into JSON as: [ null, null, null, null, null ] It isn't possible for the server to determine what the truncation point is from that diff. The solution is to therefore truncate the array _before_ sending it to the server, providing a trailing null to indicate that a truncation has occurred: [ null, null, null ] The above means that the first two indexes are unmodified, and that index 2 and later should all be truncated. * doc/client.texi (Saving to Server): New section. * src/client/transport/XhttpQuoteTransport.js (_truncateDiff): New method to perform truncation. (getBucketDataJson): Use it. * test/client/transport/XhttpQuoteTransportTest.js: New file with respective test case.
* doc: Add @testrefjs macroMike Gerwitz2018-03-071-1/+9
| | | | * doc/macros.texi (testrefjs): New macro for SRCURI and non-SRCURI.
* .gitignore: Ignore *.t2pMike Gerwitz2018-02-071-0/+1
|
* doc: Begin documentation of DOM abstractionMike Gerwitz2018-02-061-2/+104
| | | | * doc/program.texi (DOM Abstraction): New section.
* doc: Add trivia macroMike Gerwitz2018-02-062-6/+19
| | | | | | | | | | Useful for random historical facts that give useful context for developers of Liza. It hopefully helps to mitigate some of the issues of Theory Building as noted by Peter Naur. * doc/liza.css: Refactor some styles to make them more concise. (.trivia): Add styling. * doc/macros.texi (trivia): Add macro.
* StackedGroupUi: New groupv3.4.0Mike Gerwitz2018-02-021-0/+8
| | | | | | | | * doc/program.texi (Group Styles): Add `stacked' to table. * src/client/ClientDependencyFactory.js (createGroupUi): Recognize `stacked'. * src/css/base.css (.stack-header): Style stack header. * src/ui/group/StackedGroupUi.js: New group class.
* doc: Justify manual textMike Gerwitz2018-02-021-1/+7
| | | | * doc/liza.css (body)[text-align]: Justify.
* doc: Group documentationv3.3.0Mike Gerwitz2018-02-021-2/+108
| | | | | | | | | The primary motivation behind this change was documentation of links. Developers (including myself---it's been a while) misinterpreted then as references to existing groups, not arbitrary names. * doc/program.texi (Defining Groups): New section. (Group Styles): Reference to new section.
* doc: {dev=>devnotice}, add devnotesMike Gerwitz2018-02-022-6/+24
| | | | | | | | | * doc/liza.css: Each of the entities below may have additional selectors following them, not listed here. (.doc-notice.dev): Renamed to `.devnotice'. (.doc-notice.devnotice, .doc-notice.devnote): New classes. * doc/macros.texi (devnotice): {dev=>devnotice} @noticestart argument. (devnote): New macro.
* doc/pred.texi: UI predicates are existentialMike Gerwitz2018-02-011-2/+2
| | | | | | | I'm not sure why I put universal here---they affect each index individually. * doc/pred.texi (Predicate System): {universal=>existentail}
* Basic documentation for bucket diffMike Gerwitz2017-09-061-1/+83
| | | | * doc/bucket.texi (Bucket Diff): Add documentation.
* doc: Fix bin/server reference under ServerMike Gerwitz2017-08-311-2/+2
| | | | | * doc/server.texi (Server): Fix bin/server reference, which was broken when SRCURI was set.
* Extract bucket init code into ProgramInitMike Gerwitz2017-08-301-1/+3
| | | | | | | | | | | | | | | | | | | This represents a portion of the refactoring that I had intended to do until I realized that there was a simpler solution to the problem that we were having (having proguic add stored calculated values to the defaults object). So ideally we'll continue extracting all quote init code out of `Server' and into `ProgramInit' in the future. * doc/server.texi (Liza Server): Mention `ProgramInit'. * src/program/ProgramInit.js: Add class. * src/server/DocumentServer.js: Use it. * src/server/Server.js (_progInit): Add private field. (__construct): Accept ProgramInit instance and assign to field. (initQuote): Use promise returned by `_getDefaultBucket'. (_getDefaultBucket): Proxy to `ProgramInit#init', which returns a promise.
* doc: Server invocation and configurationMike Gerwitz2017-08-291-9/+41
| | | | | | * doc/server.texi (Liza Server): Add information on starting the server. (Server Configuration): Add subsection.
* doc/Makefile.am (liza_TEXINFOS): Add missing license.texiMike Gerwitz2017-06-291-1/+1
|
* Populate document metadata using Data APIsMike Gerwitz2017-06-283-3/+104
| | | | | | | | What a cluster. This was a lot of work to work around existing, bad APIs; there is no time to refactor at the moment; this already took much longer than expected.
* doc: Began server documentationMike Gerwitz2017-06-225-5/+249
| | | | * server.texi: Add file.
* doc: Add @jsmethod macroMike Gerwitz2017-06-211-0/+6
| | | | * doc/macros.texi (@jsmethod): Add macro.
* doc: Add @todoMike Gerwitz2017-06-211-0/+5
| | | | * doc/macros.texi (@todo): Add macro.
* doc: Add beginning of dapi documentationMike Gerwitz2017-06-214-1/+158
| | | | | | | * doc/Makefile.am (liza_TEXINFOS) [dapi.texi]: Include file. * doc/dapi.texi: Add file. * doc/design.texi: Add mention in list and reference chapter. * doc/liza.texi: Reference chapter.
* doc: Add @progxmlref, @dapi, @procguic{,x}ref, @proguicrefsuffixMike Gerwitz2017-06-211-0/+21
| | | | | * doc/macros.texi (@progxmlref, @dapi, @progcuicref, @proguicxref @proguicrefsuffix): Add macros.
* doc: Add @srcrefjs macrosMike Gerwitz2017-06-211-2/+12
| | | | * doc/macros.texi (srcrefjs): Add macros when src is both available and not
* doc: Update @helpwanted textMike Gerwitz2017-06-211-1/+1
| | | | * doc/macros.texi (helpwanted): Adjust phrasing to account for some existing text.
* doc: Extract design sections into own chaptersMike Gerwitz2017-06-219-439/+487
| | | | | | | * assert.texi, bucket.texi, client.texi, pred.texi, program.texi, validation.texi: New files. * design.texi: Extract text into above. * liza.texi: Add @menu references and @include each new file.
* Add missing FDL textMike Gerwitz2017-06-202-0/+512
| | | | | | | ...! No idea how this was missed. * doc/license.texi: Add file. * liza.texi: Use it.
* Remove mvnotices from docsMike Gerwitz2017-06-132-21/+0
| | | | | | | Liza has been liberated. * doc/design.texi: Remove all @mvnotice calls. * doc/macros.texi (mvnotice): Remove macro.
* LoVullo Associates => R-T SpecialtyMike Gerwitz2017-06-086-11/+11
| | | | | | | | | | Copyright notices updated. More casual references to "LoVullo Associates" replaced with "RT Specialty / Lovullo", which will be "RT Specialty Buffalo" in the future. Or "RT Specialty", depending on how this is rolled out. Or "Ryan Specialty Group". Who knows. "R-T Specialty, LLC." is the legal name, which includes the dash. Not to be confused with a certain television network.
* Add event graph diagramMike Gerwitz2017-06-082-0/+183
| | | | | * doc/diagram/event-graph.dot: Add graph. * doc/diagram/.gitignore: Ignore `*.svg'.
* Add diagram generation with graphvizMike Gerwitz2017-06-082-1/+12
| | | | | | | * configure.ac (TWOPI, HAS_TWOPI): Add variables. Check for towpi. * doc/.gitignore (diagrams/*.svg): Add output file ignore. * doc/Makefile.am: Add svg diagram building.
* doc/design.texi (Group Styles): Put table into floatMike Gerwitz2017-03-231-0/+4
|
* doc/liza.css: Change fontMike Gerwitz2017-03-231-30/+8
| | | | | This imports from Google, which is a privacy risk. These should be moved to be hosted locally; their download can be scripted.
* doc/liza.texi: Add predicate system documentationMike Gerwitz2017-03-231-0/+112
|
* doc/liza.css: Example block and float stylingMike Gerwitz2017-03-231-0/+8
|
* doc/macros.texi (@progxml): Add macroMike Gerwitz2017-03-231-0/+6
|
* doc/macros.texi: Fix PDF output issues with @maintenanceMike Gerwitz2017-03-232-7/+27
| | | | | doc/macros.texi (@maintstart, @maintend): Add macros. (@maintenance): Use them.
* doc/macros.texi (@xmlnode, @xmlattr): Add macrosMike Gerwitz2017-03-231-0/+10
|
* doc/macros.texi (@tip): Add macroMike Gerwitz2017-03-232-3/+21
| | | | doc/liza.css: Add tip notice styling.
* doc/design.texi (Program UI): Add noticesMike Gerwitz2017-03-231-1/+21
| | | | (Client): Add reference to Program UI in notice.
* doc/macros.texi (@refactornotice): Add macroMike Gerwitz2017-03-231-0/+8
|
* doc/macros.texi (@srcrefraw): Add macroMike Gerwitz2017-03-231-0/+8
| | | | I do not think Texinfo supports optional macro arguments.