architeuthidae commented 3 months ago

ARTIQ Pull Request

Added missing frontend methods to Utilities (creating get_argparser when necessary). Refactored detailed explanation of artiq_coremgmt out of reference to keep it clean and into Core device (cut down some). Added (complete?) list of currently used config keys. Formatting fixes in reference pages ~~and somewhat tangentially in Installing (not strictly related except that the config key list is pretty heavily interreferenced with it.)~~

Added AFWS password restrictions as referenced from support instructions

Description of Changes

Related Issue

Closes #1025

Type of Changes

	Type
✓	:scroll: Docs

Steps (Choose relevant, delete irrelevant before submitting)

All Pull Requests

[x] Use correct spelling and grammar.

Documentation Changes

[x] Check, test, and update the documentation in doc/. Build documentation (cd doc/manual/; make html) to ensure no errors.

Git Logistics

[x] Split your contribution into logically separate changes (git rebase --interactive). Merge/squash/fixup commits that just fix or amend previous commits. Remove unintended changes & cleanup. See tutorial.
[x] Write short & meaningful commit messages. Review each commit for messages (git show). Format:
```
topic: description. < 50 characters total.

Longer description. < 70 characters per line
```

Licensing

See copyright & licensing for more info. ARTIQ files that do not contain a license header are copyrighted by M-Labs Limited and are licensed under LGPLv3+.

architeuthidae commented 3 months ago

rebased for merge conflict

architeuthidae commented 2 months ago

Re: last commit -- source order seems like a better choice; it e.g. groups all the decorators and all the argument types together, whereas alphabetical has them spread out in an unintuitive way. In theory it's nice to be able to find things alphabetically too but these references aren't that long and in practice I'm sure anybody would be using ctrl+F.