Improving documentation:
- The necessary API token scope is `write:issue`
- Removed the sentence about issue URL since it's not actually required for creating SocialHub topic.
- Other minor edits.
Reviewed-on: https://codeberg.org/fediverse/fep/pulls/155
Co-authored-by: silverpill <silverpill@firemail.cc>
Co-committed-by: silverpill <silverpill@firemail.cc>
This pull requests contains the basic automation scripts as described in `ISSUE_TEMPLATES/README.md`.
Feps needed to be changed to continue links to their tracking issues.
- [x] Description of how to best merge a pull request still missing
- [x] Rename folder ISSUE_TEMPLATES to something better.
Co-authored-by: Helge <helge.krueger@gmail.com>
Reviewed-on: https://codeberg.org/fediverse/fep/pulls/117
- Use "decentralized identifiers" instead of "cryptographic keys" in summary.
- Fix property name in "Proof generation" section.
- Use jcs-eddsa-2022 cryptosuite in the example.
- Change domains in example according to https://www.rfc-editor.org/rfc/rfc2606#section-2.
- Add outbox to actor document example.
- Add "Linking identities" section.
- Add JSON-LD context.
- Fix typo in example.
alternate considerations: there is litepub:formerRepresentations which is not defined anywhere extant as far as i can tell, but i assume it would have been a collection containing former representations of the object itself rather than activities targeting the object.
Co-authored-by: a <a@trwnh.com>
Reviewed-on: https://codeberg.org/fediverse/fep/pulls/112
Co-authored-by: a <trwnh@noreply.codeberg.org>
Co-committed-by: a <trwnh@noreply.codeberg.org>
as discussed in https://socialhub.activitypub.rocks/t/fep-a4ed-the-fediverse-enhancement-proposal-process/1171/38?u=trwnh onward, and as described in https://socialhub.activitypub.rocks/t/fep-a4ed-the-fediverse-enhancement-proposal-process/1171/57?u=trwnh
Open considerations:
1. This PR copies `feps/fep-xxxx.md` to `fep/xxxx/fep-xxxx.md` for now. There is some consideration for naming it `index.md` instead, in order to ease with potential future static site generation via CI/CD. Imagine a CI/CD task that clones the repo and generates a proper site using `fep` as the content directory. (The idea is that this site may then be served to anyone requesting text/html representations of the `https://w3id.org/fep/xxxx` URI following the specifications laid out in FEP-9606.)
2. This PR does not yet delete any old paths. Everything in `feps/` has been edited to contain a Markdown link to the new location.
Rationale:
- We have encountered FEPs that wish to create their own assets, and the current structure is confusingly laid out. Asset colocation is widely considered a "best practice" for this sort of scenario. Particularly in cases where the rest of the repo's structure may potentially change in the future, asset colocation prevents any FEP-specific links from breaking because those links can be written relative to their FEP root.
- To ease PURL resolution, context documents can be considered sidecar assets to each FEP that defines extension terms. The mechanism for this is again described in FEP-9606. Redirection rules can be simplified to use less conditions, since the base folder remains the same.
Next steps:
- Edit the README.md to update the instructions for submitting a new FEP (pending open consideration 1)
- Set a timeline for when or if the old `feps/` directory should be removed (pending open consideration 2)
- Merge this PR
Co-authored-by: a <a@trwnh.com>
Reviewed-on: https://codeberg.org/fediverse/fep/pulls/109
Co-authored-by: a <trwnh@noreply.codeberg.org>
Co-committed-by: a <trwnh@noreply.codeberg.org>
a
silverpill
silverpill
Helge
Claire
helge
Evan Prodromou
John Livingston
0x1C3B00DA
a
David Sterry
Pere Lev