Commit Graph
65 Commits
Author SHA1 Message Date
Athanasius 36ca116095 docs/Contribyting: Schema READMEs shouldn't repeat what the JSON file states 2022-01-30 17:35:03 +00:00
Athanasius 8de80a868a docs: More DRY and getting things in the correct places 2022-01-30 15:29:41 +00:00
Athanasius 3b8845d31a docs: Resolving where "general message contents" lives and its format
* Most of it is once more in schemas/README.
* But keeping the horizons/odyssey flags in docs/Developers.md, as that's
  more about how you handle them in code.
2022-01-30 14:14:59 +00:00
Athanasius 692c28bd75 docs/Developers: Be *very* explicit about the live upload URL 2022-01-30 14:03:16 +00:00
Athanasius 10c43e5304 docs/Developers: Use relative schemas/ link & tweak horizons/odyssey flags reference 2022-01-30 13:07:38 +00:00
Athanasius ead10a2c1e docs/Developers: Tweak to why EDMC uses CAPI 2022-01-30 12:59:35 +00:00
Athanasius de4900ac67 docs/Developers: Import remaining portion of old schemas/README 2022-01-30 12:57:44 +00:00
Athanasius 3e69b7b630 docs: Move most of schemas/README into docs/Developers.md 2022-01-30 12:46:20 +00:00
Athanasius 4ade29866c docs/Contributing.md: Add some section separators 2022-01-30 12:40:53 +00:00
Athanasius 396a2f0b3a docs/schemas: Improve "what must be present or removed" 2022-01-30 12:38:32 +00:00
Athanasius 3a2b1d0309 docs/Contributing: Reference schema template files 2022-01-29 18:31:02 +00:00
Athanasius f384572027 docs/Contributing: Small grammar tweak 2022-01-29 18:27:16 +00:00
Athanasius 180fe9ec94 docs/Contributing: Minor rewording for better grammar 2022-01-28 17:51:32 +00:00
Athanasius 0e791c53b4 docs/Contributing: Keep "must be valid JSON" etc in one place 2022-01-28 17:43:30 +00:00
Athanasius 43ea088f7a docs/Contributing: 'bried' typo 2022-01-28 17:37:52 +00:00
Athanasius 779fa75b1e docs/Contributing: Branches, Code Changes, Fix/Enhancement, and more 2022-01-28 17:36:30 +00:00
Athanasius f1d8a509ca docs/Contributing: Require test files for new schemas
* Let's have examples in the scripts/testing/gatewat-response directory.
* Actually you usually don't actually need to actually use the word actually.
2022-01-28 17:36:30 +00:00
Athanasius 4239729632 docs/Contributing: Further Schema/README requirements 2022-01-28 17:36:30 +00:00
Athanasius f8f7b58607 docs/Contributing: Start work on specific Schema/README requirements 2022-01-28 17:36:29 +00:00
Athanasius e50b57a538 docs/Contributing: Adding 'new schema' guidelines 2022-01-28 17:36:23 +00:00
Athanasius 8ac2ac8ac6 Start a docs/Contributing.md
* Call out the .editorconfig file
2022-01-27 18:23:28 +00:00
Athanasius 8f23bce119 docs/Adding-A-New-Schema: Notes for future reference 2021-09-23 09:41:35 +00:00
Athanasius e3053dc0b6 systemd: Updates for it to work with current paradigm 2021-07-06 13:29:29 +00:00
Athanasius 474e0e694d docs/Running: Correct virtualenv command to use env name 2021-07-06 12:49:29 +00:00
Athanasius 0e3ef098ab systemd/start-eddn-service: Now replacing scripts/run-from-source.sh
* Removed scripts/run-from-source.sh as it's now redundant.
* Added `--background` optional argument, only for when using
  `--from-source` to start-eddn-service.  The script will leave the
  service in the foreground, no output redirection, without it.

  It tells you the PID of the process when it's backgrounded, as well as
  placing it in the appropriate .pid file.
2021-07-06 11:17:52 +00:00
Athanasius 3116927b12 run-from-source: Moved into new ./scripts/ directory 2021-07-06 10:04:55 +00:00
Athanasius 4bfa81cde8 docs/Running: systemd files now in root rather than contrib/ 2021-07-06 10:04:13 +00:00
Athanasius 547ec2bc22 docs/Running: Section-ise the setup.py install section
* Moves the "you need to edit these files in the monitor" into a section
  related to this, rather than up in #concepts.
2021-07-05 14:36:24 +00:00
Athanasius 50d7af3149 docs/Running: Catch up installation docs with current scripting 2021-07-05 14:16:08 +00:00
Athanasius 0bcb9cc545 docs/Running: Specify network/firewall config, correct some paths and ...
* <hr> between sections
* Document the ports that *must* be open to the internet.
* Apache will require the proxy_http module.
* Move the github clone earlier in instructions, as part of ensuring
  paths exist when they should.
* Note about needing to do hostname and port substitutions in monitor
  files if not using the standard values.
* Link to other sections where appropriate.
2021-07-05 12:52:50 +00:00
Athanasius fcd316c7d4 docs/Running: Edit and expand LetsEncrypt section 2021-07-02 18:04:34 +00:00
Athanasius 096ccab9fb docs/Running: Outline for using Apache 2021-07-01 17:30:48 +00:00
Athanasius 4e343fe444 docs/running: a start on apache config 2021-07-01 18:11:13 +01:00
Athanasius 451b93db1d docs/Running: Correct placement of "Reverse Proxy with nginx" section 2021-07-01 15:41:44 +01:00
Athanasius d16e222a99 docs/Running: Mandate the python venv installation
Let's stop guessing at how the reader wants to do it and just *tell*
them how to do it instead.

Python virtual environment, done.
2021-06-14 17:12:43 +01:00
Athanasius db7b69473b docs/: Add example override config file 2021-06-14 17:12:28 +01:00
Athanasius c6db4b2733 docs/Running: ${HOME} not ~ / python venv un-versioned symbolic link
* Let's stick with Bourne Shell, not BASH-isms.
* If we make everything use ~/eddn/python-venv symbolic link then
there's less to update in the future.
2021-06-14 16:52:04 +01:00
Athanasius 165a00599f docs/Running: We should use a python venv 2021-06-14 15:15:10 +01:00
Athanasius 5dc0e345fa docs/Running-this-software: Call out contrib/systemd 2021-06-14 12:33:14 +01:00
Athanasius c383d97fee docs: Basic instructions on putting existing LetsEncrypt cert files in place 2021-06-04 15:24:40 +01:00
Athanasius adaa6822f0 docs: Add some information from the VPS Anthor has been using. 2021-06-04 14:22:14 +01:00
Athanasius e47b3e4021 docs/Running: Correct and clarify the Apache Proxy examples. 2021-05-19 11:32:42 +01:00
Athanasius c5070c7754 docs/Running: Be explicit about the mysql password use 2021-05-19 11:28:03 +01:00
Athanasius ad236365f8 docs/running: Add dpkg output of the tested VM.
The debian-vm-dpkg_-l.txt is likely the most useful as it includes the
exact versions of the packages.  This might help resolve any "uh,
doesn't work on *my* system" conundrums.
2021-05-17 08:25:34 +01:00
Athanasius 5f12722c9f docs/running: Order steps more logically.
* Also adds some minimal Apache guidance for Reverse Proxy setup.
2021-05-16 20:59:03 +01:00
Athanasius ae4f54b608 docs/running: Move DB init after DB install/setup
* Also we might as well make examples clearer by assuming
  `~/eddn/dev/EDDN/` for the git clone.
2021-05-16 20:47:34 +01:00
Athanasius f195a53872 docs/running: Detail the ports each process uses and why. 2021-05-16 20:45:03 +01:00
Athanasius 7dce35d442 docs/running: expand/correct/improve iptables rules for VM testing 2021-05-16 20:30:53 +01:00
Athanasius a64ca249d1 docs/running: Add section on needing to search/replace monitor files 2021-05-16 20:27:56 +01:00
Athanasius 66bb88abca docs/running: cp -r not cp -p 2021-05-16 19:31:10 +01:00