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
|
||||
|
||||
_(January 25, 2026)_
|
||||
|
||||
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.
|
||||
@@ -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.
|
||||
- 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,
|
||||
quality standards, and maintainability requirements. Submission of a contribution _shall not_ guarantee review, acceptance, or
|
||||
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
|
||||
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
|
||||
|
||||
As per our [Code of Conduct](CODE-OF-CONDUCT.md), AI contributions are acceptable, but the submitting contributor _must:_
|
||||
* Fully understand the contribution.
|
||||
* 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.
|
||||
AI contributions are allowed, but _must_ follow the policy set out in our [Code of Conduct](CODE-OF-CONDUCT.md). Failure to do so
|
||||
will result in summary rejection of contributions and possible restriction of participation in the project.
|
||||
|
||||
## Contribution Workflow
|
||||
|
||||
|
||||
@@ -37,7 +37,7 @@ Amsterdam is _not_ designed to be:
|
||||
|
||||
* A large-scale social media platform
|
||||
* 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.
|
||||
|
||||
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
|
||||
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
|
||||
|
||||
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),
|
||||
"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",
|
||||
or just ":port" to listen on all interfaces.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user