From f94918a22b460e279055fb56a0d3aebd68e76acf Mon Sep 17 00:00:00 2001 From: Amy Gale Ruth Bowersox Date: Tue, 24 Mar 2026 15:06:45 -0600 Subject: [PATCH] Claude's input on the three big docs --- CODE-OF-CONDUCT.md | 6 ++++-- CONTRIBUTING.md | 28 ++++------------------------ README.md | 14 ++------------ 3 files changed, 10 insertions(+), 38 deletions(-) diff --git a/CODE-OF-CONDUCT.md b/CODE-OF-CONDUCT.md index ff4a499..45800d6 100644 --- a/CODE-OF-CONDUCT.md +++ b/CODE-OF-CONDUCT.md @@ -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. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8a71da7..b02761f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -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 diff --git a/README.md b/README.md index 921b5de..ef1364b 100644 --- a/README.md +++ b/README.md @@ -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.