]> Untitled Git - lemmy.git/blobdiff - RELEASES.md
Change references of dev.lemmy.ml to lemmy.ml (#1281)
[lemmy.git] / RELEASES.md
index 44de088aa56eb064e210817430106a22b4feb4e0..b362d7f17c006ab8f0cd073efadd6429be88c87f 100644 (file)
-# Lemmy v0.7.0 Release (2020-06-22)
+# Lemmy v0.8.0 Release (2020-10-16)
 
-## Breaking Change to our image server: Pictshare to Pict-rs migration guide
+## Changes
 
-This release replaces [pictshare](https://github.com/HaschekSolutions/pictshare) with [pict-rs](https://git.asonix.dog/asonix/pict-rs), and a script must be run on your server to upgrade.
+We've been working at warp speed since our `v0.7.0` release in June, adding over [870 commits](https://github.com/LemmyNet/lemmy/compare/v0.7.0...main) since then. :sweat: 
 
-To update, run:
+Here are some of the bigger changes:
 
+### LemmyNet projects
+
+- Created [LemmyNet](https://github.com/LemmyNet), where all lemmy-related projects live.
+- Split out the frontend into a separete repository, [lemmy-ui](https://github.com/LemmyNet/lemmy-ui)
+- Created a [lemmy-js-client](https://github.com/LemmyNet/lemmy-js-client), for any js / typescript developers.
+- Split out i18n [lemmy-translations](https://github.com/LemmyNet/lemmy-translations), that any app or site developers can import and use. Lemmy currently supports [~30 languages!](https://weblate.yerbamate.ml/projects/lemmy/lemmy/)
+
+### Lemmy Server
+
+#### Federation
+
+- The first **federation public beta release**, woohoo :fireworks: 
+- All Lemmy functionality now works over ActivityPub (except turning remote users into mods/admins)
+- Instance allowlist and blocklist
+- Documentation for [admins](https://lemmy.ml/docs/administration_federation.html) and [devs](https://lemmy.ml/docs/contributing_federation_overview.html) on how federation works
+- Upgraded to newest versions of @asonix activitypub libraries
+- Full local federation setup for manual testing
+- Automated testing for nearly every federation action
+- Many additional security checks
+- Lots and lots of refactoring
+- Asynchronous sending of outgoing activities
+
+### User Interface
+
+- Separated the UI from the server code, in [lemmy-ui](https://github.com/LemmyNet/lemmy-ui).
+- The UI can now read with javascript disabled! 
+- It's now a fully isomorphic application using [inferno-isomorphic](https://infernojs.org/docs/guides/isomorphic). This means that page loads are now much faster, as the server does the work.
+- The UI now also supports open-graph and twitter cards! Linking to lemmy posts (from whatever platform you use) looks pretty now: ![](https://i.imgur.com/6TZ2v7s.png)
+- Improved the search page ( more features incoming ).
+- The default view is now `Local`, instead of `All`, since all would show all federated posts.
+- User settings are now shared across browsers ( a page refresh will pick up changes ).
+- A much leaner mobile view.
+
+#### Backend
+
+- Re-organized the rust codebase into separate workspaces for backend and frontend.
+- Removed materialized views, making the database **a lot faster**.
+- New post sorts `Active` (previously called hot), and `Hot`. Active shows posts with recent comments, hot shows highly ranked posts.
+- New sort for `Local` ( meaning from local communities).
+- Customizeable site, user, and community icons and banners.
+- Added user preferred names / display names, bios, and cakedays.
+- Visual / Audio captchas through the lemmy API.
+- Lots of API field verifications.
+- Upgraded to pictrs-v2 ( thanks to @asonix )
+- Wayyy too many bugfixes to count.
+
+## Contributors
+
+We'd also like to thank both the [NLnet foundation](https://nlnet.nl/) for their support in allowing us to work full-time on Lemmy ( as well as their support for [other important open-source projects](https://nlnet.nl/project/current.html) ), [those who sponsor us](https://lemmy.ml/sponsors), and those who [help translate Lemmy](https://weblate.yerbamate.ml/projects/lemmy/). Every little bit does help. We remain committed to never allowing advertisements, monetizing, or venture-capital in Lemmy; software should be communal, and should benefit humanity, not a small group of company owners. 
+
+## Upgrading
+
+- [with manual Docker installation](https://lemmy.ml/docs/administration_install_docker.html#updating)
+- [with Ansible installation](https://lemmy.ml/docs/administration_install_ansible.html)
+
+## Testing Federation
+
+Federation is finally ready in Lemmy, pending possible bugs or other issues. So for now we suggest to enable federation only on test servers, or try it on our own test servers ( [enterprise](https://enterprise.lemmy.ml/), [ds9](https://ds9.lemmy.ml/), [voyager](https://voyager.lemmy.ml/) ).
+
+If everything goes well, after a few weeks we will enable federation on lemmy.ml, at first with a limited number of trusted instances. We will also likely change the domain to https://lemmy.ml . Keep in mind that changing domains after turning on federation will break things.
+
+To enable on your instance, edit your [lemmy.hjson](https://github.com/LemmyNet/lemmy/blob/main/config/defaults.hjson#L60) federation section to `enabled: true`, and restart.
+
+### Connecting to another server
+
+The server https://ds9.lemmy.ml has open federation, so after either adding it to the `allowed_instances` list in your `config.hjson`, or if you have open federation, you don't need to add it explicitly.
+
+To federate / connect with a server, type in `!community_name@server.tld`, in your server's search box [like so](https://voyager.lemmy.ml/search/q/!main%40ds9.lemmy.ml/type/All/sort/TopAll/page/1).
+
+To connect with the `main` community on ds9, the search is `!main@ds9.lemmy.ml`.
+
+You can then click the community, and you will see a local version of the community, which you can subscribe to. New posts and comments from `!main@ds9.lemmy.ml` will now show up on your front page, or `/c/All`
+
+# Lemmy v0.7.40 Pre-Release (2020-08-05)
+
+We've [added a lot](https://github.com/LemmyNet/lemmy/compare/v0.7.40...v0.7.0) in this pre-release:
+
+- New post sorts `Active` (previously called hot), and `Hot`. Active shows posts with recent comments, hot shows highly ranked posts.
+- Customizeable site icon and banner, user icon and banner, and community icon and banner.
+- Added user preferred names / display names, bios, and cakedays.
+- User settings are now shared across browsers (a page refresh will pick up changes).
+- Visual / Audio captchas through the lemmy API.
+- Lots of UI prettiness.
+- Lots of bug fixes.
+- Lots of additional translations.
+- Lots of federation prepping / additions / refactors.
+
+This release removes the need for you to have a pictrs nginx route (the requests are now routed through lemmy directly). Follow the upgrade instructions below to replace your nginx with the new one.
+
+## Upgrading
+
+**With Ansible:**
+
+```
+# run these commands locally
+git pull
+cd ansible
+ansible-playbook lemmy.yml
 ```
+
+**With manual Docker installation:**
+```
+# run these commands on your server
 cd /lemmy
-wget https://raw.githubusercontent.com/dessalines/lemmy/master/docker/prod/docker-compose.yml
-wget https://raw.githubusercontent.com/dessalines/lemmy/master/docker/prod/migrate-pictshare-to-pictrs.bash
-sudo bash migrate-pictshare-to-pictrs.bash
+wget https://raw.githubusercontent.com/LemmyNet/lemmy/master/ansible/templates/nginx.conf
+# Replace the {{ vars }}
+sudo mv nginx.conf /etc/nginx/sites-enabled/lemmy.conf
+sudo nginx -s reload
+wget https://raw.githubusercontent.com/LemmyNet/lemmy/master/docker/prod/docker-compose.yml
+sudo docker-compose up -d
 ```
 
-You'll also have to update your nginx config, use the [one here](https://github.com/LemmyNet/lemmy/blob/master/ansible/templates/nginx.conf).
 
-*You'll have to log in again to pick up your avatar*
+# Lemmy v0.7.0 Release (2020-06-23)
+
+This release replaces [pictshare](https://github.com/HaschekSolutions/pictshare)
+with [pict-rs](https://git.asonix.dog/asonix/pict-rs), which improves performance
+and security.
+
+Overall, since our last major release in January (v0.6.0), we have closed over
+[100 issues!](https://github.com/LemmyNet/lemmy/milestone/16?closed=1)
 
-Apart from that, we've closed [~100 issues!](https://github.com/LemmyNet/lemmy/milestone/16?closed=1), including:
+- Site-wide list of recent comments
+- Reconnecting websockets
+- Many more themes, including a default light one.
+- Expandable embeds for post links (and thumbnails), from
+[iframely](https://github.com/itteco/iframely)
+- Better icons
+- Emoji autocomplete to post and message bodies, and an Emoji Picker
+- Post body now searchable
+- Community title and description is now searchable
+- Simplified cross-posts
+- Better documentation
+- LOTS more languages
+- Lots of bugs squashed
+- And more ...
+
+## Upgrading
+
+Before starting the upgrade, make sure that you have a working backup of your
+database and image files. See our
+[documentation](https://lemmy.ml/docs/administration_backup_and_restore.html)
+for backup instructions.
+
+**With Ansible:**
+
+```
+# deploy with ansible from your local lemmy git repo
+git pull
+cd ansible
+ansible-playbook lemmy.yml
+# connect via ssh to run the migration script
+ssh your-server
+cd /lemmy/
+wget https://raw.githubusercontent.com/LemmyNet/lemmy/master/docker/prod/migrate-pictshare-to-pictrs.bash
+chmod +x migrate-pictshare-to-pictrs.bash
+sudo ./migrate-pictshare-to-pictrs.bash
+```
+
+**With manual Docker installation:**
+```
+# run these commands on your server
+cd /lemmy
+wget https://raw.githubusercontent.com/LemmyNet/lemmy/master/ansible/templates/nginx.conf
+# Replace the {{ vars }}
+sudo mv nginx.conf /etc/nginx/sites-enabled/lemmy.conf
+sudo nginx -s reload
+wget https://raw.githubusercontent.com/LemmyNet/lemmy/master/docker/prod/docker-compose.yml
+wget https://raw.githubusercontent.com/LemmyNet/lemmy/master/docker/prod/migrate-pictshare-to-pictrs.bash
+chmod +x migrate-pictshare-to-pictrs.bash
+sudo bash migrate-pictshare-to-pictrs.bash
+```
 
-- Site-wide list of recent comments.
-- Reconnecting websockets.
-- Swapped out pictshare for [pict-rs](https://git.asonix.dog/asonix/pict-rs).
-- Lots more themes, including a default light one.
-- Expandable embeds for post links (and thumbnails), from iframely.
-- Better icons.
-- Emoji autocomplete to post and message bodies, and an Emoji Picker.
-- Post body now searchable.
-- Community title and description is now searchable.
-- Simplified cross-posts.
-- Better documentation.
-- LOTS more languages.
-- Lots of bugs squashed.
+**Note:** After upgrading, all users need to reload the page, then logout and
+login again, so that images are loaded correctly.
 
 # Lemmy v0.6.0 Release (2020-01-16)
 
@@ -54,4 +203,4 @@ This is the biggest release by far:
 
 Another major announcement is that Lemmy now has another lead developer besides me, [@felix@radical.town](https://radical.town/@felix). Theyve created a better documentation system, implemented RSS feeds, simplified docker and project configs, upgraded actix, working on federation, a whole lot else.
 
-https://dev.lemmy.ml
+https://lemmy.ml