diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1d628524..50366d06 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,7 +6,7 @@ We welcome contributions to Freenet! Here's what you need to know. - **Claim the issue first.** Comment on the issue you want to work on and wait for a maintainer to confirm before starting work. This prevents duplicate effort and ensures the approach is aligned with project direction. - **Read the codebase conventions.** See [AGENTS.md](AGENTS.md) for project structure, coding standards, and testing requirements. -- **Ask questions.** If something is unclear, ask on the issue or in our [Matrix channel](https://matrix.to/#/#freenet:matrix.org) before writing code. +- **Ask questions.** If something is unclear, ask on the issue or in our [Matrix channel](https://matrix.to/#/#freenet-locutus:matrix.org) before writing code. ## Quality Standards @@ -31,7 +31,7 @@ We require the use of a frontier-class model (as of early 2026: Claude Opus 4, G ## Getting Help -- [Matrix chat](https://matrix.to/#/#freenet:matrix.org) for questions and discussion +- [Matrix chat](https://matrix.to/#/#freenet-locutus:matrix.org) for questions and discussion - [Issue tracker](https://github.com/freenet/freenet-core/issues) for bugs and feature requests - [API docs](https://docs.rs/freenet) for code reference - [Freenet manual](https://freenet.org/resources/manual/) for architecture overview diff --git a/hugo-site/content/_index.md b/hugo-site/content/_index.md index 0fe488f2..c987150f 100644 --- a/hugo-site/content/_index.md +++ b/hugo-site/content/_index.md @@ -131,6 +131,7 @@ just a few hops, scaling efficiently to millions of peers, no servers required. [River](/river/) · [Apps](/apps/) · [Video Talks](/about/video-talks/) · [Matrix Chat](https://matrix.to/#/#freenet-locutus:matrix.org) · -[GitHub](https://github.com/freenet/freenet-core) · [FAQ](/about/faq/) +[GitHub](https://github.com/freenet/freenet-core) · [FAQ](/about/faq/) · +[Report a Bug](/community/support/) diff --git a/hugo-site/content/build/manual/community.md b/hugo-site/content/build/manual/community.md index 4ab158e5..8fd6f6fb 100644 --- a/hugo-site/content/build/manual/community.md +++ b/hugo-site/content/build/manual/community.md @@ -7,4 +7,4 @@ aliases: --- - [Github](https://github.com/freenet/freenet-core) -- [Matrix](https://matrix.to/#/#locutus:matrix.org) +- [Matrix](https://matrix.to/#/#freenet-locutus:matrix.org) diff --git a/hugo-site/content/community/_index.md b/hugo-site/content/community/_index.md new file mode 100644 index 00000000..f6f270de --- /dev/null +++ b/hugo-site/content/community/_index.md @@ -0,0 +1,5 @@ +--- +title: "Community" +date: 2026-08-25 +draft: false +--- diff --git a/hugo-site/content/community/get-involved/index.md b/hugo-site/content/community/get-involved/index.md deleted file mode 100644 index 20ce255e..00000000 --- a/hugo-site/content/community/get-involved/index.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: "Get Involved" -date: 2024-06-11T00:00:00Z -draft: false ---- diff --git a/hugo-site/content/community/support/index.md b/hugo-site/content/community/support/index.md index db845062..177b7471 100644 --- a/hugo-site/content/community/support/index.md +++ b/hugo-site/content/community/support/index.md @@ -1,5 +1,127 @@ --- -title: "Support" -date: 2024-06-11T00:00:00Z +title: "Report a Bug or Get Help" +description: + "Where to report a Freenet bug or ask for a feature: which project, which issue tracker, and what + to include." +date: 2026-08-25 draft: false +aliases: + - /report/ + - /community/get-involved/ --- + +Found a bug, or want something Freenet doesn't do yet? Please tell us. This page points you at the +right place to say it. + +Freenet is a network plus a set of separate apps built on top of it, and each one keeps its own list +of bugs. So the first step is picking which one you were using. If you pick wrong, we'll move your +report for you. + +Filing a report on GitHub needs a free GitHub account. If you'd rather not create one, say it in +[our Matrix room](https://matrix.to/#/#freenet-locutus:matrix.org) instead and someone will file it +for you. + +## What were you using? + +### Group chat (River) + +Messages not sending, a room that won't load, an invite that doesn't work, members missing, anything +in the chat interface itself. + +→ [Report a River bug](https://github.com/freenet/river/issues/new) · +[existing River issues](https://github.com/freenet/river/issues) + +### Freenet itself + +Install or uninstall trouble, the node won't start or won't stay running, no connections, high CPU +or bandwidth use, the menu bar or system tray icon, errors from the `freenet` command. Anything +underneath the apps rather than inside one. + +→ [Report a Freenet bug](https://github.com/freenet/freenet-core/issues/new) · +[existing Freenet issues](https://github.com/freenet/freenet-core/issues) + +### This website + +A broken link, documentation that's wrong or confusing, a page that won't load, a typo. + +→ [Report a website bug](https://github.com/freenet/web/issues/new) · +[existing website issues](https://github.com/freenet/web/issues) + +### Ghost Keys + +Trouble with the Ghostkey Vault: importing a key, backing one up, an app that can't get a signature. + +→ [Report a Ghostkey Vault bug](https://github.com/freenet/ghostkeys/issues/new) · +[existing Ghostkey Vault issues](https://github.com/freenet/ghostkeys/issues) + +A donation that didn't go through, or a Ghost Key certificate that never arrived, is handled by this +website rather than by the vault, so [report those here](https://github.com/freenet/web/issues/new). + +### One of the other apps + +Each keeps its own list: [Delta](https://github.com/freenet/delta/issues/new), +[Mail](https://github.com/freenet/mail/issues/new), +[freenet-git](https://github.com/freenet/freenet-git/issues/new), +[Raven](https://github.com/freenet/raven/issues/new), +[Atlas](https://github.com/freenet/atlas/issues/new) and +[Harvest](https://github.com/freenet/harvest/issues/new). The [apps page](/apps/) says what each one +does, if you're not sure which you were using. + +### Not sure + +Use the [Freenet issue tracker](https://github.com/freenet/freenet-core/issues/new). It's the one +the maintainers watch most closely, and they'll move your report if it belongs somewhere else. +Describing clearly what happened matters far more than landing it in the right place the first time. + +If you'd rather have someone work it out with you, ask in +[Matrix](https://matrix.to/#/#freenet-locutus:matrix.org). + +## What to put in a bug report + +You don't need to diagnose the problem. What makes a report easy to act on: + +- What you were doing, what you expected, and what happened instead. +- Whether it happens every time or only sometimes. +- Your operating system, and how you installed Freenet. +- A screenshot, if it's something you can see. + +### The quick way to gather diagnostics + +If Freenet is installed on your machine, run this in a terminal: + +```bash +freenet service report +``` + +It gathers your version, operating system, recent log entries and configuration, then asks you to +describe the problem, uploads everything, and prints a short **report code** that looks like +`X7K2M9`. Put that code in your bug report and the maintainers can pull up everything they need. If +your node isn't answering, that step waits up to a minute before giving up, so the prompt may take a +while to appear. + +That upload is more than logs, so it's worth knowing what's in it: your machine's hostname, recent +log lines, your Freenet configuration file (which includes paths containing your username), and, if +your node is running, its current network state. That state covers your peer ID, the addresses of +the peers you're connected to, and every contract your node holds. For River that includes the rooms +you're in. + +Your IP address is recorded when the upload is received. + +If you'd rather read all of that before sending it, `freenet service report --local report.json` +writes the same bundle to a file on your own machine and uploads nothing. There's no way to send a +saved file afterwards, so once you're happy with it, run the command again without `--local` and it +will collect a fresh copy of the same things. + +## Prefer to talk to a person? + +Our [Matrix room](https://matrix.to/#/#freenet-locutus:matrix.org) is where Freenet's developers and +users are. It's a good place for "is this even a bug?", for questions the FAQ doesn't answer, and +for anything you'd rather not write up as a formal report. + +## Want to help fix things? + +A clear bug report is already a real contribution. If you want to go further, +[freenet-core's contributing guide](https://github.com/freenet/freenet-core/blob/main/CONTRIBUTING.md) +explains how the project takes changes. Read it before you write any code: feature work needs an +agreed issue first, and pull requests that skip that step get closed. The [Build section](/build/) +covers how Freenet works and how to write apps for it. diff --git a/hugo-site/content/donate/thanks/_index.md b/hugo-site/content/donate/thanks/_index.md index f755475d..0f11dc7d 100644 --- a/hugo-site/content/donate/thanks/_index.md +++ b/hugo-site/content/donate/thanks/_index.md @@ -13,6 +13,6 @@ are tax-deductible in the United States. ### Stay connected -- Join the conversation on [Matrix](https://matrix.to/#/#freenet:matrix.org) +- Join the conversation on [Matrix](https://matrix.to/#/#freenet-locutus:matrix.org) - Follow project updates on [our news page](/about/news/) - Read about the architecture in the [whitepaper](/whitepaper/) diff --git a/hugo-site/content/quickstart/_index.md b/hugo-site/content/quickstart/_index.md index e8158c39..3e308233 100644 --- a/hugo-site/content/quickstart/_index.md +++ b/hugo-site/content/quickstart/_index.md @@ -44,7 +44,7 @@ Prefer the terminal? River has a full-featured CLI, `riverctl`. See the ## Troubleshooting If you run into problems, join our [Matrix chat](https://matrix.to/#/#freenet-locutus:matrix.org) -for help. +for help, or see [Report a Bug or Get Help](/community/support/) for where to file a report. **Invite didn't work?** If River opened but you're not in the room, try restarting Freenet (`freenet service restart`), then come back to this page and click the invite button again for a @@ -67,4 +67,4 @@ Need to remove Freenet? See the [uninstall guide](/uninstall/). - [User Manual](/build/manual/) - Learn how Freenet works - [Video Talks](/about/video-talks/) - Watch presentations about Freenet - [FAQ](/about/faq/) - Common questions and answers -- [Get Involved](/community/get-involved/) - Contribute to the project +- [Report a Bug or Get Help](/community/support/) - Where to send a bug report or feature idea diff --git a/hugo-site/static/slides/common/call-to-action.html b/hugo-site/static/slides/common/call-to-action.html index ec7f6baf..076c8f55 100644 --- a/hugo-site/static/slides/common/call-to-action.html +++ b/hugo-site/static/slides/common/call-to-action.html @@ -35,7 +35,7 @@

Get Involved

freenet.org GitHub - Matrix + Matrix

@@ -45,7 +45,7 @@

Get Involved

  • Run a peer: freenet.org/quickstart
  • Build: tutorial at freenet.org/resources/manual/tutorial, uses River as example
  • AI: dapp-builder skill for Claude
  • -
  • Matrix: #freenet:matrix.org
  • +
  • Matrix: #freenet-locutus:matrix.org
  • diff --git a/hugo-site/static/slides/common/questions.html b/hugo-site/static/slides/common/questions.html index 539cf014..61c215d8 100644 --- a/hugo-site/static/slides/common/questions.html +++ b/hugo-site/static/slides/common/questions.html @@ -12,7 +12,7 @@

    💬 - Matrix: #freenet:matrix.org + Matrix: #freenet-locutus:matrix.org

    𝕏 diff --git a/hugo-site/themes/freenet/assets/css/freenet.css b/hugo-site/themes/freenet/assets/css/freenet.css index 5e8df7f9..96c3e185 100644 --- a/hugo-site/themes/freenet/assets/css/freenet.css +++ b/hugo-site/themes/freenet/assets/css/freenet.css @@ -1107,6 +1107,20 @@ picture.app-screenshot img { } } +/* Bug-report route in the footer — the one support link present on every page, + so it has to read as a link rather than as a caption. Shares the quiet + underlined link treatment with .footer-institutional below. */ +.footer-report { + text-align: center; + margin: 2rem auto 0; + padding: 0 1rem; + font-size: 0.9rem; +} + +.footer-report p { + margin: 0; +} + /* Institutional statement in footer — quiet, just establishes 501(c)(3) status */ .footer-institutional { max-width: 720px; @@ -1122,29 +1136,34 @@ picture.app-screenshot img { margin: 0; } -.footer-institutional a { +.footer-institutional a, +.footer-report a { color: #64748b; text-decoration: underline; text-decoration-color: rgba(100, 116, 139, 0.4); text-underline-offset: 2px; } -.footer-institutional a:hover { +.footer-institutional a:hover, +.footer-report a:hover { color: var(--color-primary); text-decoration-color: var(--color-primary); } @media (prefers-color-scheme: dark) { .footer-institutional, - .footer-institutional a { + .footer-institutional a, + .footer-report a { color: #94a3b8; } - .footer-institutional a { + .footer-institutional a, + .footer-report a { text-decoration-color: rgba(148, 163, 184, 0.4); } - .footer-institutional a:hover { + .footer-institutional a:hover, + .footer-report a:hover { color: #4da6ff; text-decoration-color: #4da6ff; } diff --git a/hugo-site/themes/freenet/layouts/partials/footer.html b/hugo-site/themes/freenet/layouts/partials/footer.html index 140bca16..0fadbb5a 100644 --- a/hugo-site/themes/freenet/layouts/partials/footer.html +++ b/hugo-site/themes/freenet/layouts/partials/footer.html @@ -1,3 +1,6 @@ +