Claude's input on the three big docs

This commit is contained in:
2026-03-24 15:06:45 -06:00
parent 7a7a837af2
commit f94918a22b
3 changed files with 10 additions and 38 deletions
+4 -2
View File
@@ -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
View File
@@ -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
+2 -12
View File
@@ -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.