summary refs log tree commit diff
path: root/Documentation/contributing/communication.adoc
Commit message (Collapse)AuthorAge
* Documentation: clarify use of announce@Alyssa Ross2024-01-19
| | | | | | | | There has never been a message sent to this list, because I consider the announcement list to be for communicating actionable things to potential users, and we haven't had any of those yet. Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: mention that bugs go to devel@Alyssa Ross2024-01-19
| | | | Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: improve prose of communication pageAlyssa Ross2024-01-19
| | | | | | | | | | | | There was a lot of fluff here that got in the way of actually finding the information people are coming to this page to find. "You are strongly encouraged to mirror them." is probably confusing to people who don't know what mirroring this, so rephrase this to make it clearer that this isn't something people need to worry about in that case. Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: remove references to mailman-webAlyssa Ross2024-01-19
| | | | | | | | | | | | | | | | | | | | | | | Bots have been nonconsensually creating mailman-web accounts for people to flood them with spam. Aside from using reCAPTCHA (ugh) or modifying mailman-web, the only thing I can really do to prevent this is to disable unauthenticated web subscriptions, and the creation of mailman-web accounts, which I have now done. Ideally, it would be possible to configure it so that creating mailman-web accounts is only allowed for email addresses that have already subscribed to the list by sending an email, but that's not currently the case. This makes Postorius useless to people who don't already have an account. Hyperkitty is still useful, but people without existing accounts won't be able to use it to post to the lists, and the UI still shows Sign In and Sign Up links, which is pretty confusing when signups are disabled. It doesn't really offer anything that public-inbox doesn't any more. As a result of these changes, I'm removing all references to mailman-web from the documentation. Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: emphasize Matrix over IRCAlyssa Ross2023-08-30
| | | | | | | Most people probably want Matrix. People looking for IRC will still easily find it. Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: restore participating.html anchorsAlyssa Ross2023-08-26
| | | | | | | | | | | This page used to be at <https://spectrum-os.org/participating.html>, which now redirects here. Let's keep the original anchors working. To have anchors for each mailing list, they have to be their own section. This probably makes more sense than a table anyway, and will render better on narrow viewports. Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: add missing copyright noticeAlyssa Ross2023-08-23
| | | | | | | This documentation was copied from the Spectrum website's participating.html, which I wrote while not working for Unikie. Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: suggest the new Matrix channelAlyssa Ross2023-08-23
| | | | | | | This is a port of www commit 2a73682 ("participating.html: suggest the new Matrix room"). Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: fix accidental highlight textAlyssa Ross2023-08-23
| | | | | | | | | AsciiDoctor will generate <mark> elements around text enclosed in '#' characters. We mean a literal hash. (Escaping the later '#' for the Matrix channel alias is unnecessary and in fact will just render a '\'). Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: fix accidental anchor linksAlyssa Ross2023-05-29
| | | | | | | | | | | | | | | The xref macro is for cross references to internal links within the documentation, not external links. xref:https://… results in an anchor link. The existing doc-links test didn't catch this, because it operates at the HTTP level. But the problem is easy to spot in the sources, so I've added a new check that just greps for this pattern. Reported-by: Ryan Lahfa <ryan@lahfa.xyz> Fixes: 97cceff ("Documentation: add contributing information") Signed-off-by: Alyssa Ross <hi@alyssa.is> Message-Id: <20230527151152.2016164-1-hi@alyssa.is>
* Documentation: fix IRC and Matrix channel namesAlyssa Ross2023-05-27
| | | | | Fixes: 97cceff ("Documentation: add contributing information") Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: fix missing space after periodAlyssa Ross2023-05-27
| | | | | Fixes: 97cceff ("Documentation: add contributing information") Signed-off-by: Alyssa Ross <hi@alyssa.is>
* Documentation: move "Working with Patches" under "Contributing"Alyssa Ross2023-02-21
| | | | | | | | This is all information about how to contribute to Spectrum, so I think it makes more sense here than under "Development". Signed-off-by: Alyssa Ross <hi@alyssa.is> Message-Id: <20230211145650.740649-1-hi@alyssa.is>
* Documentation: add contributing informationJenni Nikolaenko2023-01-20
Hello there! I decided to create a patch from my drafts so this information will not be lost. It still needs some attention. It is a good idea to have the documentation in one place. For us this means that information from these pages https://spectrum-os.org/contributing.html, https://spectrum-os.org/participating.html -- should be moved here https://spectrum-os.org/participating.html. What I did particularly: 1. Added a new chapter "Contributing". Copied here the information from here https://spectrum-os.org/contributing.html, adapting a bit to Spectrum Docs. 2. Moved the "Building Documentation" section from "Development" to "Contributing". 3. In the "Contributing" chapter you can find the following structure: - Communication in Spectrum (copied from https://spectrum-os.org/participating.html) - Documentation Style Guide - Building Documentation I tried to fix all cross-reference links, so this new content can be used right now. Any further updates are very welcome. Signed-off-by: Jenni Nikolaenko <evgeniia.nikolaenko@unikie.com> Message-Id: <20230119154307.28303-1-evgeniia.nikolaenko@unikie.com> Reviewed-by: Alyssa Ross <hi@alyssa.is> Signed-off-by: Alyssa Ross <hi@alyssa.is>