Claude's input on the three big docs
This commit is contained in:
+4
-2
@@ -1,7 +1,5 @@
|
|||||||
# Code of Conduct - Amsterdam Web Communities System Project
|
# Code of Conduct - Amsterdam Web Communities System Project
|
||||||
|
|
||||||
_(January 25, 2026)_
|
|
||||||
|
|
||||||
For purposes of this document, the sole maintainer of the Amsterdam project is Amy G. Bowersox, `amy@erbosoft.com`.
|
For purposes of this document, the sole maintainer of the Amsterdam project is Amy G. Bowersox, `amy@erbosoft.com`.
|
||||||
|
|
||||||
Any violations of this Code of Conduct may be reported to the maintainers, as listed above.
|
Any violations of this Code of Conduct may be reported to the maintainers, as listed above.
|
||||||
@@ -44,6 +42,10 @@ Contributors may use software tools, including AI-assisted tools, but the submit
|
|||||||
- Be able to explain design and implementation decisions without the use of AI.
|
- Be able to explain design and implementation decisions without the use of AI.
|
||||||
- Accept responsibility for maintenance and correctness.
|
- Accept responsibility for maintenance and correctness.
|
||||||
|
|
||||||
|
Contributors should indicate AI-generated content in issue and pull request descriptions and comments, specifying which model was used.
|
||||||
|
|
||||||
|
Do _not_ use AI to reply to questions about your issue or pull request. The questions are for _you,_ the human, not an AI model.
|
||||||
|
|
||||||
Project maintainers retain _full discretion_ to accept or reject contributions for any reason consistent with the project's goals,
|
Project maintainers retain _full discretion_ to accept or reject contributions for any reason consistent with the project's goals,
|
||||||
quality standards, and maintainability requirements. Submission of a contribution _shall not_ guarantee review, acceptance, or
|
quality standards, and maintainability requirements. Submission of a contribution _shall not_ guarantee review, acceptance, or
|
||||||
ongoing support.
|
ongoing support.
|
||||||
|
|||||||
+4
-24
@@ -10,33 +10,13 @@ While you may have found this project on GitHub or another site, the "source of
|
|||||||
reside on [the Erbosoft code hosting site](https://git.erbosoft.com/amy/amsterdam). This is to ensure long-term
|
reside on [the Erbosoft code hosting site](https://git.erbosoft.com/amy/amsterdam). This is to ensure long-term
|
||||||
independence from platforms controlled by third parties; the mirrors to GitHub and/or other sites are for visibility.
|
independence from platforms controlled by third parties; the mirrors to GitHub and/or other sites are for visibility.
|
||||||
|
|
||||||
Serious contributors should contact [Amy Bowersox](https://links.inclusiveladyship.com/@amy) for access.
|
Serious contributors should contact Amy Bowersox (amy@erbosoft.com or via a contact method listed in
|
||||||
|
[her LinkStack](https://links.inclusiveladyship.com/@amy)) for access.
|
||||||
|
|
||||||
## AI Contribution Policy
|
## AI Contribution Policy
|
||||||
|
|
||||||
As per our [Code of Conduct](CODE-OF-CONDUCT.md), AI contributions are acceptable, but the submitting contributor _must:_
|
AI contributions are allowed, but _must_ follow the policy set out in our [Code of Conduct](CODE-OF-CONDUCT.md). Failure to do so
|
||||||
* Fully understand the contribution.
|
will result in summary rejection of contributions and possible restriction of participation in the project.
|
||||||
* Be able to explain design and implementation decisions without the use of AI.
|
|
||||||
* Accept responsibility for maintenance and correctness.
|
|
||||||
|
|
||||||
Contributors should indicate AI-generated content in issue and pull request descriptions and comments, specifying which model was used.
|
|
||||||
|
|
||||||
Do _not_ use AI to reply to questions about your issue or pull request. The questions are for _you,_ the human, not an AI model.
|
|
||||||
|
|
||||||
All project contributions must be submitted by _identifiable human participants_ who accept full responsibility for their content.
|
|
||||||
Automated agents, bots, or autonomous AI systems _may not_ independently submit issues, pull requests, or other contributions.
|
|
||||||
|
|
||||||
Project maintainers retain _full discretion_ to close pull requests and issues that appear to be low-quality AI-generated content.
|
|
||||||
While we welcome new contributors, we want to see those that will engage constructively with the review process, rather than deferring
|
|
||||||
to AI.
|
|
||||||
|
|
||||||
## Building Amsterdam
|
|
||||||
|
|
||||||
From the root of the source tree, just run `go build` to build the `amsterdam` executable.
|
|
||||||
|
|
||||||
To regenerate the `tailwind.css` file (located in `ui/static/css`), you will need the Tailwind CSS command-line executable.
|
|
||||||
Download it from [the Tailwind GitHub](https://github.com/tailwindlabs/tailwindcss/releases/) and install it as `tailwindcss`
|
|
||||||
in your `PATH`. Then run `go generate` to regenerate the CSS file before you run `go build` to build the executable.
|
|
||||||
|
|
||||||
## Contribution Workflow
|
## Contribution Workflow
|
||||||
|
|
||||||
|
|||||||
@@ -37,7 +37,7 @@ Amsterdam is _not_ designed to be:
|
|||||||
|
|
||||||
* A large-scale social media platform
|
* A large-scale social media platform
|
||||||
* An algorithmic, feed-driven network.
|
* An algorithmic, feed-driven network.
|
||||||
* A replacement for services like Facebook or exTwitter.
|
* A replacement for services like Facebook or X (formerly known as Twitter).
|
||||||
* A mass-broadcast publishing system.
|
* A mass-broadcast publishing system.
|
||||||
|
|
||||||
Instead, it focuses on deliberate, human-scale conversation and community identity.
|
Instead, it focuses on deliberate, human-scale conversation and community identity.
|
||||||
@@ -93,16 +93,6 @@ during the Renaissance.
|
|||||||
This new implementation is named "Amsterdam," which was a center of community during the Age of Exploration, in particular, the
|
This new implementation is named "Amsterdam," which was a center of community during the Age of Exploration, in particular, the
|
||||||
Dutch Golden Age.
|
Dutch Golden Age.
|
||||||
|
|
||||||
## Key Features
|
|
||||||
|
|
||||||
* Multiple communities hosted on a single site
|
|
||||||
* A discussion system featuring the linear conferencing model
|
|
||||||
* Long-form conversation spaces
|
|
||||||
* User identities shared across communities
|
|
||||||
* Moderation and community management tools
|
|
||||||
* Archival support for historic communities
|
|
||||||
* Modern HTML rendering
|
|
||||||
|
|
||||||
## Project status
|
## Project status
|
||||||
|
|
||||||
Amsterdam is in its first (early) public release. The software is capable of running a full community site.
|
Amsterdam is in its first (early) public release. The software is capable of running a full community site.
|
||||||
@@ -157,7 +147,7 @@ By default, Amsterdam sends log messages to stdout. You can change the log level
|
|||||||
options on the command line, or the `AMSTERDAM_LOG_LEVEL` environment variable. Valid values are "trace" (most detailed),
|
options on the command line, or the `AMSTERDAM_LOG_LEVEL` environment variable. Valid values are "trace" (most detailed),
|
||||||
"debug", "info", "warn", "error", "fatal", and "panic" (least detailed).
|
"debug", "info", "warn", "error", "fatal", and "panic" (least detailed).
|
||||||
|
|
||||||
Connect to Amsterdam on port 1323 by default. You can change this with the `-l` or `--listen` options on the
|
Amsterdam listens on port 1323 by default. You can change this with the `-l` or `--listen` options on the
|
||||||
command line, or with the `AMSTERDAM_LISTEN` environment variable. Listening addresses are specified as "host:port",
|
command line, or with the `AMSTERDAM_LISTEN` environment variable. Listening addresses are specified as "host:port",
|
||||||
or just ":port" to listen on all interfaces.
|
or just ":port" to listen on all interfaces.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user