Housekeeping tasks with documentation and versioning.

This commit is contained in:
Jordan Bancino 2023-11-08 14:30:45 -05:00
parent db4ae0408c
commit 77800e4117
4 changed files with 44 additions and 28 deletions

View file

@ -1,5 +1,4 @@
<p align="center"><img src="https://telodendria.io/assets/Telodendria-500x500.png"></p> <h1 style="text-align: center;">Telodendria</h1>
<h1 align="center">Telodendria</h1>
Telodendria is an extremely powerful, yet lightweight and portable Telodendria is an extremely powerful, yet lightweight and portable
chat server designed to be easy to install and configure. Powered by chat server designed to be easy to install and configure. Powered by
@ -12,7 +11,7 @@ hosting a complicated, high-maintenance homeserver or joining an
existing homeserver for privacy or other reasons, then Telodendria existing homeserver for privacy or other reasons, then Telodendria
might be for you. might be for you.
> **Note:** Telodendria still in development. See [Status](#status). !!!! **Note:** Telodendria still in development. See **Status** below.
## What is Matrix? ## What is Matrix?
@ -64,12 +63,13 @@ incredibly outdated. Telodendria, on the other hand, aims to be stable.
It should *just work* for long periods of time between upgrades, and It should *just work* for long periods of time between upgrades, and
you should never feel like Telodendria is going to change significantly you should never feel like Telodendria is going to change significantly
between upgrades. between upgrades.
- **Well-Documented:** Telodendria places as much emphasis on documentation as on code, which means you can be sure that the documentation will always remain up-to-date, accurate, and most importantly, reasonably exhaustive.
[Read Technical Rationale &rightarrow;](docs/dev/rationale.md) [Read Technical Rationale &rightarrow;](https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/docs/dev/rationale.md)
## Get Started ## Get Started
Check out the [Documentation](docs/README.md) to get started with Check out the [Documentation](https://git.telodendria.io/Telodendria/telodendria/src/branch/master/docs/README.md) to get started with
Telodendria. Telodendria.
## Status ## Status
@ -79,13 +79,13 @@ not yet deliver on all of its promises. Currently, Telodendria is not
ready for end-users yet. While it features very basic user ready for end-users yet. While it features very basic user
authentication, it does not actually work as a chat server yet. authentication, it does not actually work as a chat server yet.
We are hoping to ship Telodendria `v0.4.0` by May of 2024. This We are hoping to ship Telodendria `v1.7.0-alpha4` by May of 2024. This
release should be usable for communication between **local users** release should be usable for communication between **local users**
only. Additional features, including federation with other Matrix only. Additional features, including federation with other Matrix
homeservers will be added in future releases. homeservers will be added in future releases.
You can help speed up development by [sponsoring](#sponsorship) You can help speed up development by **sponsoring**
Telodendria or [getting involved](docs/CONTRIBUTING.md). Telodendria or [getting involved](https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/docs/CONTRIBUTING.md).
## Sponsorship ## Sponsorship
@ -96,7 +96,7 @@ Telodendria's long-term success, please consider sponsoring the
project. project.
You can make a recurring donation to Telodendria using You can make a recurring donation to Telodendria using
[LiberaPay](https://bancino.net/Telodendria/donate). You can also make [LiberaPay](https://liberapay.com/Telodendria/donate). You can also make
one-time donations using one-time donations using
[Stripe](https://donate.stripe.com/8wM29AfF5bRJc48eUU). If you would [Stripe](https://donate.stripe.com/8wM29AfF5bRJc48eUU). If you would
like to make a recurring donation larger than that allowed by like to make a recurring donation larger than that allowed by
@ -108,7 +108,7 @@ LiberaPay, please contact Jordan Bancino over Matrix at
While there are no set sponsorship tiers at this time, sponsoring While there are no set sponsorship tiers at this time, sponsoring
Telodendria is a mutually beneficial relationship. Depending on the Telodendria is a mutually beneficial relationship. Depending on the
amount you donate, you can get your name, logo, and website links amount you donate, you can get your name, logo, and website links
on the [Sponsors](docs/SPONSORS.md) page, the project `README`, or the on the [Sponsors](../sponsors) page, the project `README`, or the
main website. main website.
## License ## License
@ -116,7 +116,7 @@ main website.
All of the code and documentation for Telodendria is licensed under a All of the code and documentation for Telodendria is licensed under a
modified MIT license. The MIT license is an extremely permissive modified MIT license. The MIT license is an extremely permissive
license that has very few restrictions. Please consult the license that has very few restrictions. Please consult the
[`LICENSE.txt`](LICENSE.txt) file for the actual license text. It is [`LICENSE.txt`](https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/LICENSE.txt) file for the actual license text. It is
important to note that the Telodendria license text differs from the important to note that the Telodendria license text differs from the
original MIT license in the following ways: original MIT license in the following ways:
@ -133,4 +133,3 @@ to use the logo in any way as long as it represents or links to the
official project. If Telodendria is forked, the logo must be removed official project. If Telodendria is forked, the logo must be removed
completely from the project, and optionally replaced by a different completely from the project, and optionally replaced by a different
one. one.

2
configure vendored
View file

@ -19,7 +19,7 @@ LIBS="-lm -pthread -lCytoplasm"
# Set default args for all platforms # Set default args for all platforms
SCRIPT_ARGS="--cc=cc --prefix=/usr/local --enable-ld-extra --bin-name=telodendria --version=0.4.0 --static $@" SCRIPT_ARGS="--cc=cc --prefix=/usr/local --enable-ld-extra --bin-name=telodendria --version=1.7.0-alpha4 --static $@"
echo "Processing options..." echo "Processing options..."
echo "Ran with arguments: $SCRIPT_ARGS" echo "Ran with arguments: $SCRIPT_ARGS"

View file

@ -5,12 +5,22 @@ It is intended to be updated with every commit that makes a user-facing change w
reporting in the change log. As such, it changes frequently between releases. Final reporting in the change log. As such, it changes frequently between releases. Final
change log entries are published as [Releases](releases). change log entries are published as [Releases](releases).
## v0.4.0 ## v1.7.0-alpha4
**Not Released Yet.** **Not Released Yet.**
This release brings filters, rooms, and events! The core of the Matrix protocol architecture This release brings filters, rooms, and events! The core of the Matrix
is not in place. protocol architecture is now in place.
Note that the versioning scheme has changed from `v0.X.0` to
`v1.7.0-alphaX`. This is so that Telodendria releases correspond to the
Matrix specification that they implement, in accordance with
[this blog post](https://telodendria.io/blog/on-matrixs-release-cadence-and-state-resolution-v1).
This versioning scheme change does not indicate a drastic leap forward
in Telodendria's development&mdash;the `-alpha4` suffix indicates that
this is the 4th pre-release, with the target being a stable `v1.7.0`.
Note also that we still have a *long* way to go before we reach that
stable release.
### Matrix Specification ### Matrix Specification
@ -21,21 +31,23 @@ The following endpoints were added:
### Bug Fixes & General Improvements ### Bug Fixes & General Improvements
- Fixed a double-free in `RouteUserProfile()` that would cause errors with certain - Fixed a double-free in `RouteUserProfile()` that would cause errors
Matrix clients. (#35) with certain Matrix clients. (#35)
- Improved compatibility with NetBSD on various platforms. - Improved compatibility with NetBSD on various platforms.
- Moved [Cytoplasm](/Telodendria/Cytoplasm) to its own repository. - Moved [Cytoplasm](/Telodendria/Cytoplasm) to its own repository. It
- Use a `configure` script and `make` to build Telodendria instead of custom scripts. will now be maintained separately and have its own releases as well.
- Use a `configure` script and `make` to build Telodendria instead of
custom scripts.
### New Features ### New Features
- Implemented `/_telodendria/admin/v1/deactivate/[localpart]` for admins to be able to - Moved all administrator API endpoints to `/_telodendria/admin/v1`,
deactivate users. because later revisions of the administrator API may break clients, so
- Added a **PUT** option to `/_telodendria/admin/v1/config` that gives the ability to change we want a way to give those breaking revisions new endpoints.
only a subset of the configuration. - Implemented `/_telodendria/admin/v1/deactivate/[localpart]` for admins
- Moved all administrator API endpoints to `/_telodendria/admin/v1`, because later revisions to be able to deactivate users.
of the administrator API may break clients, so we want a way to give those breaking revisions - Added a **PUT** option to `/_telodendria/admin/v1/config` that gives
new endpoints. the ability to change only a subset of the configuration.
## v0.3.0 ## v0.3.0

View file

@ -35,7 +35,12 @@ ROUTE_IMPL(RouteVersions, path, argp)
(void) path; (void) path;
(void) argp; (void) argp;
ArrayAdd(versions, JsonValueString("v1.6")); #define DECLARE_SPEC_VERSION(x) ArrayAdd(versions, JsonValueString(x))
DECLARE_SPEC_VERSION("v1.7");
/* Declare additional spec version support here. */
#undef DECLARE_SPEC_VERSION
HashMapSet(response, "versions", JsonValueArray(versions)); HashMapSet(response, "versions", JsonValueArray(versions));
return response; return response;