Merge branch '189-keep-a-changelog' into 'develop'

Introduce improved changelog

Closes #189

See merge request !205

CHANGELOG.md

+# Changelog
+The format is based on [Keep a Changelog] and this project adheres to [Semantic Versioning].
+
+## [Unreleased]
+### Added
+### Changed
+- Introduce proper changelog format (#189)
+- Moved DB migration scripts into `db` folder
+### Deprecated
+### Removed
+### Fixed
+### Security
+
+## [2.3.1] - 2018-08-05
+### Added
+- Podmins can link directly to their pod via `https://podupti.me/domain.name` for stats and to allow users to rate easier
+- Wizard to help you filter the columns to what you need (#145)
+### Changed
+- Now one table with a basic default view you can customize (#171)
+
+## [2.3.0] - 2018-07-19
+:exclamation: DB migrations required! (see [SQL migration script][2.2.0-sql-migration])
+### Added
+- Language is detected based on your homepage, edit your homepage to non-en if that is what you use
+- Add development and release dates to `masterversions` table (#143)
+- Store full country name, store days monitored each pod (#150)
+- Store detectedlanguage (#144)
+- Show version and update in full view cleaner (#143)
+- Filter and search on the columns of data (#147)
+- Paginate the results so they fit per page (#147)
+### Changed
+- Podmins can no longer access `db/pull.php` to test their pod, they can however get to a debug screen from the edit pod area
+- Edit will send to email on file and be less delay, runner of site does not really have any way to verify email address
+- Default new pods to `UP` to be checked
+- Use the git API for release versions, check development releases on pods (#143)
+- Move from [bower to yarn](https://bower.io/blog/2017/how-to-migrate-away-from-bower/) for packages
+- Move to PHP 7.2 with strict typing
+- Move to [Eslint compliance](https://eslint.org/docs/rules/)
+- Move to [PSR-2 compliance](https://www.php-fig.org/psr/psr-2/)
+- NOTE `config.php.example` change to full paths for 2 items!
+- Show time as human readable everywhere (#150)
+### Removed
+- Unused `hidden` and `secure` columns (#140, #141)
+### Fixed
+- Rename table `rating_comments` to `ratingcomments` for redbean support (#146)
+### Security
+- Forbid access to files that should be CLI only (#152)
+
+## [2.2.0] - 2018-05-12
+:exclamation: DB migrations required! (see [SQL migration script][2.2.0-sql-migration])
+### Added
+- Podmins can now pause/unpause or delete from podmin area
+- Graph on user growth on the network
+- Add monthly stats table
+### Changed
+- `go.php` auto select picks a more stable pod than before
+- Make map prettier
+- Use lines on tables to make them more readable
+- Don't delete dead pods, keep them and data for history hide them for users
+- Put daily tasks in the `pull.sh` and run each day
+- Update status to 1-5 rather than text
+### Fixed
+- Fix ipv6
+
+[2.2.0-sql-migration]: https://git.feneas.org/diasporg/Poduptime/blob/master/db/migrations/2.1.4-2.2.0.sql
+[2.3.0-sql-migration]: https://git.feneas.org/diasporg/Poduptime/blob/master/db/migrations/2.2.0-2.3.0.sql
+
+[Unreleased]: https://git.feneas.org/diasporg/Poduptime/compare/master...develop
+[2.3.1]: https://git.feneas.org/diasporg/Poduptime/compare/2.3.0...2.3.1
+[2.3.0]: https://git.feneas.org/diasporg/Poduptime/compare/v2.2.0...2.3.0
+[2.2.0]: https://git.feneas.org/diasporg/Poduptime/compare/2.1.3...v2.2.0
+
+[Keep a Changelog]: https://keepachangelog.com/
+[Semantic Versioning]: https://semver.org/

Changelog.md

-# 2.3.x
-
-## End Users
-* Now one table with a basic default view you can customize https://git.feneas.org/diasporg/Poduptime/issues/171
-* Wizard to help you filter the columns to what you need https://git.feneas.org/diasporg/Poduptime/issues/145
-
-## Podmins
-* Can link directly to your pod via https://podupti.me/domain.name for stats and to allow users to rate easier
-
-# 2.3.0
-
-## Podmins
-* Can no longer access db/pull.php to test their pod, they can however get to a debug screen from the edit pod area
-* Language is detected based on your homepage, edit your homepage to non-en if that is what you use
-* Edit will send to email on file and be less delay, runner of site does not really have anyway to verify email address
-
-## DB
-* Add development and release dates to masterversions table https://git.feneas.org/diasporg/Poduptime/issues/143
-* Store full country name, store days monitored each pod https://git.feneas.org/diasporg/Poduptime/issues/150
-* Store detectedlanguage https://git.feneas.org/diasporg/Poduptime/issues/144
-* DB migrations see db/version.md
-* rename table rating_comments to ratingcomments for redbean support https://git.feneas.org/diasporg/Poduptime/issues/146
-* Default new pods to UP to be checked
-* Remove unused hidden and secure columns https://git.feneas.org/diasporg/Poduptime/issues/141 https://git.feneas.org/diasporg/Poduptime/issues/140
-
-## Cleanup
-* Use the git API for release versions, check development releases on pods https://git.feneas.org/diasporg/Poduptime/issues/143
-* Forbid access to files that should be cli only https://git.feneas.org/diasporg/Poduptime/issues/152
-* Move from bower to yarn for packages https://bower.io/blog/2017/how-to-migrate-away-from-bower/
-* Move to PHP 7.2 with declare(strict_types=1);
-* Move to Eslint compliance https://eslint.org/docs/rules/
-* Move to PSR-2 compliance https://www.php-fig.org/psr/psr-2/
-* NOTE config.php.example change to full paths for 2 items!
-
-## End Users
-* Show version and update in full view cleaner https://git.feneas.org/diasporg/Poduptime/issues/143
-* Filter and search on the columns of data https://git.feneas.org/diasporg/Poduptime/issues/147
-* Paginate the results so they fit per page https://git.feneas.org/diasporg/Poduptime/issues/147
-* Show time as human readable everywhere https://git.feneas.org/diasporg/Poduptime/issues/150
-
-# 2.2.0
-
-## Podmins
-* Can now pause/unpause or delete from podmin area
-
-## End Users
-* go.php auto select picks a more stable pod than before
-* Graph on user growth on the network
-* Make map prettier
-* Use lines on tables to make them more readable
-
-## Cleanup
-* Don't delete dead pods, keep them and data for history hide them for users
-* Put daily tasks in the pull.sh and run each day
-* Fix ipv6
-
-## DB
-* Add monthly stats table
-* Update status to 1-5 rather than text
-* Two migrations for this version update see db/version.md

db/migrations/README.md

+# Migrations
+
+## New install
+
+When setting up a new install, import [`db/tables.sql`][tables.sql] and do not perform any migrations!
+
+## Migrating
+
+If you are upgrading your existing installation, execute the necessary migrations scripts found in [`db/migrations`][migrations].
+
+## API v1
+
+To support the original API v1 you should import [`db/pods_apiv1.sql`][pods_apiv1.sql] into your DB as often as you want your API updated.
+
+[tables.sql] https://git.feneas.org/diasporg/Poduptime/blob/master/db/tables.sql
+[migrations] https://git.feneas.org/diasporg/Poduptime/tree/master/db/migrations
+[pods_apiv1.sql] https://git.feneas.org/diasporg/Poduptime/blob/master/db/pods_apiv1.sql

db/version.md

-If new install import tables.sql and do not perform migrations
-
-If upgrading migrations are:
-
-v1.0   -> v2.0   = migration00001.sql
-
-v2.0   -> v2.1   = migration00002.sql
-
-v2.1   -> v2.1.3 = migration00003.sql
-
-v2.1.4 -> v2.2   = migration00004.sql
-
-v2.2   -> v2.3   = migrations00005.sql
-
-To support the original apiv1 you should import:
-pods_apiv1.sql 
-into your db as often as you want your api updated.