rewrite changelog with better description of changes

pull/1/head
ansuz 4 years ago
parent c691e6f49c
commit 5afbfb6950

@ -1,25 +1,22 @@
# 4.2.0-candidate (C)
# 4.2.0 (C)
## Goals
* catch up on pending branches and activities
* documentation
* translation
* stabilize
We've made a lot of big changes to the platform lately. This release has largely been an attempt to stabilize the codebase by fixing bugs and merging features that we hadn't had a chance to test until now, all while updating our documentation and removing unused or outdated code.
## Update notes
* serverside dependency updates
* removed translations. if you see something, say something
* removed /assert/translations/ and related code as this is handled by weblate
* display subscribe button on home page if subscriptions are supported
* display a home page notice via application_config.js via supplied HTML
* link to our sponsors websites via their logos
* scripts
* separate archive deletion code from inactive pad removal
* script to identify unused translations
This release includes an update to the sheet editor which is not backwards-compatible. Clients running the new version will not be able to correctly communicate with clients running older versions. Clients will automatically detect that a new version is available upon reconnecting to the server after a restart, so as long as you follow the steps recommended below this should be fine.
Otherwise, to update from 4.1.0 to 4.2.0:
We've also updated a server-side dependency that is not backwards-compatible. Failure to update both the platform and its dependencies together will result in errors.
The `scripts` directory now includes a script to identify unused translations. We used this to reduce the size of our localization files (`cryptpad/www/common/translations/*.json`). We reviewed the changes carefully and did our best to test, but it's always possible that a string was erroneously removed. If you notice any bugs in the UI where text seems to be missing, please let us (the developers) know via a GitHub issue.
CryptPad.fr now stores more than a terabyte of data, making it quite intensive to run the scripts to remove inactive files from the disk. To help alleviate this strain we've moved the code responsible for deleting files that have been archived for longer than the configured retention period into its own script (`./scripts/evict-archived.js`). For the moment this script is not integrated into the server and will not automatically run in the background as the main eviction script does. It's recommended that you run it manually if you find you are low on disk space.
Since early in the pandemic we've been serving a custom home page on CryptPad.fr to inform users that we've increased the amount of storage provided for free. This was originally intended as a temperary measure, but since almost a year has passed we figured it was about time we integrate this custom code into the platform itself. Admins can now add customized HTML in `customize/application_config.js` by defining an `AppConfig.homeNotice` attribute like so: `AppConfig.homeNotice = "<b>pewpew</b>";`.
To update from 4.1.0 to 4.2.0:
1. Stop your server
2. Get the latest code from the 4.1.0 tag (`git fetch origin && git checkout 4.1.0`, or just `git pull origin main`)
@ -28,67 +25,44 @@ Otherwise, to update from 4.1.0 to 4.2.0:
## Features
* chat color in pads, teams, and the contacts app
* rich text
* use white background for rich text documents even in dark mode
* offline improvements
* offline mode for file app
* offline teams and team shared folder
* download whiteboard from the drive
* checkup page
* translations
* update prompts related to password protection in various modals
* link to the docs from the support page's ticket creation interface
* refresh server performance stats without refreshing the admin page
* The "What is CryptPad" page now links to our sponsors websites instead of just mentioning them by name.
* We've updated the colors for the contacts app and the chat integrated into documents and teams to fit better with our other styles.
* We've reverted the styles for the rich text editor so that the document always has a white background, even in dark mode, since we could not guarantee that documents would be legible to all users if custom text colors had been applied. While we were looking at this editor, we also repositioned several buttons used to control the page's layout, including the width of the document, the presence of the table of contents, and its comments.
* We've continued to improve several key parts of the platform to accommodate offline usage. Teams, shared folders within teams, and the file app can now load and display content cached within the browser even if the client cannot establish a connection to our API server.
* The content of _whiteboard_ documents can now be downloaded directly from within team or user drives, rather than exclusively from within the whiteboard editor itself. To do so, right-click a whiteboard and choose _download_ to export a PNG file.
* Since we now regularly serve more than 125 thousand visitors a week it's gotten quite difficult to keep up with support tickets. To help alleviate this burden we're taking steps to increase the visibility of our documentation (https://docs.cryptpad.fr). The support ticket page now displays a link to that documentation above the form to create a new ticket.
* Several users have reported confusion regarding various password fields in CryptPad, in the access menu, pad creation screen, when uploading new files, and when creating a shared folder. We've updated the text associated with these fields to better indicate that they are not requesting your user password, but rather that they allow you to add an optional password as an additional layer of protection.
* Server administrators can now refresh the _performance_ table on the admin panel without reloading the page.
* We've begun working on a _checkup_ page for CryptPad to help administrators identify and fix common misconfigurations of the platform. It's still in a very basic state, but we hope to to make it a core part of the server installation guide that is under development.
* The kanban app now supports import like the rest of our apps and rejects content of any file-type other than JSON.
## Bug fixes
* chat spinner: correctly hidden when the chat finishes loading
* caused by insufficient selector specificity
* rich text
* display button to adjust document width inline instead of in toolbar
* display comments inline on mobile instead of on the right
* server
* messages are not acknowledged or broadcast until they have been validated and written to the disk
* see [#553](https://github.com/xwiki-labs/cryptpad/issues/553)
* completion of unowned uploads was broken by a change introduced in late december
* shared folders
* fix a bug: loss of access to shared folders
* related to access lists and the offline cache
* loss of access with pads loaded before the worker is ready
* dark mode
* text media-tags use markdown's block styles
* 404 page
* uses the dark theme's background color correctly
* remove an unnecessary scrollbar
* darkfix branch
* removed unused colors
* admin support last message is no longer red
* sidebar hint uses new grey name
* more severe fade on drive icon hover
* drive info box inline links are now styled
* autocomplete dropdown styles weren't applied
* notifications bell now uses same text color as toolbar title
* filepicker background color
* fix tippy popper color
* fix plaintext colors in file app
* styles
* remove round corners on limit bar
* add branded link color to support ticket attachment links in the admin panel
* OnlyOffice sheets
* use configured language from CryptPad
* support multiple locks per-user
* not backwards compatible... restart server when updating!
* fix filter/sort
* caused by the overly eager suppression of a modal
* add support for strict mode
* supports undo/redo
* [#195](https://github.com/xwiki-labs/cryptpad/issues/195)
* fix kanban import
* file upload
* warn before attempting to upload a file that is too large
* [#682](https://github.com/xwiki-labs/cryptpad/issues/682)
* disallow upload outside of the documents section of drives
* We've fixed a long list of minor stylistic inconsistencies following last release's introduction of dark mode:
* Text embedded in documents via media-tags now features the same background and text color as is applied to similar preformatted code blocks in markdown.
* The arrow portion of our tooltips had inherited an inconsistent background color from a parent element. It now uses the same color as the body of the tooltip.
* Our 404 page now correctly uses the theme's background color.
* We removed a number of unused color variables from our style sheets.
* The most recent user message of any thread on the admin panel's view of support tickets is no longer red. Since we now categorize messages according to their answered status and priority, this indicator was no longer necessary.
* We fixed some contrast issues on for pages with sidebars (settings, teams, admin, etc.) when hovering over items in the sidebar.
* Various items in the drive and pad type selection menu also had contrast issues when hovering over options.
* Links in the drive's info boxes and in the admin panel are now correctly styled with the same color as links throughout the rest of the platform.
* Race conditions between conflicting styles for autocomplete dropdowns caused them to be displayed behind other elements under certain circumstances.
* The "bell" icon which we use for the notifications menu in the toolbar now uses the same color as documents' titles, rather than the color of the editor's toolbar.
* Items in the filepicker modal which is opened by various apps' "Insert" menu now have a lighter grey background instead of the almost-black color applied in 4.1.0.
* The storage limit indicator shown in the bottom-left corner of user and team drives no longer has round corners.
* An insufficiently specific CSS selector caused the "spinner" animation to persist in the chat interface after it should have been hidden.
* The client will now check whether a file is larger than is allowed by the server before attempting to upload it, rather failing only when the server rejects the upload.
* The drive no longer allows files to be dragged and dropped into locations other than the "Documents" section, as it did not make sense for files to be displayed anywhere else.
* We identified and fixed a number of issues which caused shared folders that were protected with access lists to fail to load due to race conditions between loading the document and authenticating with the server as a user or member of a team. This could also result in a loss of access to documents stored exclusively in those shared folders.
* We've fixed a number of server issues:
1. A change in a function signature in late December caused the upload of unowned files to fail to complete.
2. Messages sent via websocket are no longer broadcast to other members of a session until they have been validated by the server and stored on the disk. This was not a security issue as clients validate messages anyway, however, it could cause inconsistencies in documents when some members of a session incorrectly believed that a message had been saved.
3. A subtle race condition in very specific circumstances could cause the server's in-memory index for a given session to become incorrect. This could cause one or two messages to be omitted when requesting the most recent history. We observed this in practice when some clients did not realize they had been kicked from a team. This is unlikely to have affected anyone in practice because it only occurred when reconnecting using cached messages for the document which records team membership, and this functionality is only being introduced in this release.
* We spent a lot of time improving our integration of OnlyOffice's sheet editor:
* The editor is now initialized with your CryptPad account's preferred language.
* We realized that our peer-to-peer locking system (which replaces the server-based system provided by OnlyOffice's document server) did not correctly handle multiple locks per user. This caused errors when filtering and sorting columns. We've improved our locking system so these features should now work as expected, but old clients will not understand the new format. As mentioned in the "Update notes" section, admins must follow the recommended update steps to ensure that all clients correctly update to the latest version.
* We've removed a restriction we imposed to ensure all users editing a sheet were using OnlyOffice's "fast mode", since we now support the alternative "strict mode". In strict mode, changes you make to the document are not sent until you choose to save (using a button or by pressing ctrl+s). This introduces some additional complexity into our integration, however, it enables support for undoing local changes as per [issue #195](https://github.com/xwiki-labs/cryptpad/issues/195).
# 4.1.0 (B)

Loading…
Cancel
Save