1
1
Fork 0
mirror of https://code.mensbeam.com/MensBeam/Arsse.git synced 2024-12-22 21:22:40 +00:00

Draft documentation

This commit is contained in:
J. King 2018-12-10 19:13:48 -05:00
parent 73729a6be8
commit a8e6487001
3 changed files with 23 additions and 2 deletions

View file

@ -1,3 +1,12 @@
Version 0.6.0 (????-??-??)
==========================
New features:
- Support for PostgreSQL databases (via PDO)
Changes:
- Improve performance of common database queries by 80-90%
Version 0.5.1 (2018-11-10) Version 0.5.1 (2018-11-10)
========================== ==========================

View file

@ -4,7 +4,7 @@ The Arsse is a news aggregator server which implements multiple synchronization
At present the software should be considered in an "alpha" state: though its core subsystems are covered by unit tests and should be free of major bugs, not everything has been rigorously tested. Additionally, many features one would expect from other similar software have yet to be implemented. Areas of future work include: At present the software should be considered in an "alpha" state: though its core subsystems are covered by unit tests and should be free of major bugs, not everything has been rigorously tested. Additionally, many features one would expect from other similar software have yet to be implemented. Areas of future work include:
- Support for more database engines (PostgreSQL, MySQL, MariaDB) - Support for more database engines (MySQL, MariaDB)
- Providing more sync protocols (Google Reader, Fever, others) - Providing more sync protocols (Google Reader, Fever, others)
- Better packaging and configuration samples - Better packaging and configuration samples
@ -16,7 +16,9 @@ The Arsse has the following requirements:
- PHP 7.0.7 or later with the following extensions: - PHP 7.0.7 or later with the following extensions:
- [intl](http://php.net/manual/en/book.intl.php), [json](http://php.net/manual/en/book.json.php), [hash](http://php.net/manual/en/book.hash.php), and [pcre](http://php.net/manual/en/book.pcre.php) - [intl](http://php.net/manual/en/book.intl.php), [json](http://php.net/manual/en/book.json.php), [hash](http://php.net/manual/en/book.hash.php), and [pcre](http://php.net/manual/en/book.pcre.php)
- [dom](http://php.net/manual/en/book.dom.php), [simplexml](http://php.net/manual/en/book.simplexml.php), and [iconv](http://php.net/manual/en/book.iconv.php) (for picoFeed) - [dom](http://php.net/manual/en/book.dom.php), [simplexml](http://php.net/manual/en/book.simplexml.php), and [iconv](http://php.net/manual/en/book.iconv.php) (for picoFeed)
- [sqlite3](http://php.net/manual/en/book.sqlite3.php) or [pdo_sqlite](http://ca1.php.net/manual/en/ref.pdo-sqlite.php) - Either of:
- [sqlite3](http://php.net/manual/en/book.sqlite3.php) or [pdo_sqlite](http://ca1.php.net/manual/en/ref.pdo-sqlite.php) for SQLite databases
- [pdo_pgsql](http://ca1.php.net/manual/en/ref.pdo-pgsql.php) for PostgreSQL 9.1 or later databases
- Privileges to create and run daemon processes on the server - Privileges to create and run daemon processes on the server
## Installation ## Installation
@ -69,6 +71,10 @@ The Arsse is made available under the permissive MIT license. See the `LICENSE`
Please refer to `CONTRIBUTING.md` for guidelines on contributing code to The Arsse. Please refer to `CONTRIBUTING.md` for guidelines on contributing code to The Arsse.
## Database compatibility notes
Functionally there is no reason to prefer either SQLite or PostgreSQL over the other. SQLite, however, is significantly simpler to set up in most cases, requiring only read and write access to a containing directory in order to function. PostgreSQL may perform better than SQLite when serving hundreds of users or more, but this has not been tested.
## Protocol compatibility notes ## Protocol compatibility notes
### General ### General

View file

@ -9,6 +9,12 @@ When upgrading between any two versions of The Arsse, the following are usually
- If installing from source, update dependencies with `composer install -o --no-dev` - If installing from source, update dependencies with `composer install -o --no-dev`
Upgrading from 0.5.1 to 0.6.0
=============================
- The database schema has changed from rev3 to rev4; if upgrading the database manually, apply the 3.sql file
Upgrading from 0.2.1 to 0.3.0 Upgrading from 0.2.1 to 0.3.0
============================= =============================