Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add previous release notes to docs site #3409

Closed
wants to merge 2 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/docs/releases/0.1.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Mathesar 0.1.0 (alpha release)

Mathesar's first alpha release! Features:

- **Built on Postgres**: Connect to an existing Postgres database or set one up from scratch.
- **Set up your data models**: Easily create and update Postgres schemas and tables.
- **Data entry**: Use our spreadsheet-like interface to view, create, update, and delete table records.
- **Filter, sort, and group**: Quickly slice your data in different ways.
- **Query builder**: Use our Data Explorer to build queries without knowing anything about SQL or joins.
- **Schema migrations**: Transfer columns between tables in two clicks.
- **Uses Postgres features**: Mathesar uses and manipulates Postgres schemas, primary keys, foreign keys, constraints and data types. e.g. "Links" in the UI are foreign keys in the database.
- **Custom data types**: Custom data types for emails and URLs (more coming soon), validated at the database level.
- **Basic access control**: Users can have Viewer (read-only), Editor (can only edit data, but not data structure), or Manager (can edit both data and its structure) roles.
- **Basic documentation**: Users can install Mathesar using Docker Compose, and tricky product features are documented.

[Full Changelog](https://github.com/centerofci/mathesar/commits/0.1.0)
24 changes: 24 additions & 0 deletions docs/docs/releases/0.1.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Mathesar 0.1.1 (alpha release)

This is a minor release focused on addressing bugs and improving user experience.

## Bug fixes

- The UI now supports non-ASCII characters in column names and column settings.
- The record page works when the primary key is not an integer.
- Mathesar can now support primary keys that are UUIDs.
- Access level permissions presented on the UI are now consistent with the API access levels.
- Deleting newly created records immediately no longer results in getting stuck in a loading screen.
- Empty columns are now inferred as text instead of boolean during import.
- The UI now displays an appropriate failure message when failing to delete rows.
- Mathesar no longer crashes when attempting to order rows by non-orderable columns.
- Row selection gets cleared correctly when a placeholder cell is selected.

## Improvements

- The UI cancels edits when users press the Esc key in table cells.
- Group headers with record summaries now have links to allow users to navigate to the associated record.
- Dropdown positioning is improved across the app, so that they do not overflow the browser window.
- A bunch of smaller visual and UX improvements made by our Google Summer of Code (GSoC) applicants.

[Full Changelog](https://github.com/centerofci/mathesar/compare/0.1.0...0.1.1)
42 changes: 42 additions & 0 deletions docs/docs/releases/0.1.2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Mathesar 0.1.2 (alpha release)

This release focuses on documenting additional options for installing Mathesar, some improvements to the user experience, and some bug fixes. We've also added support for switching between multiple databases in the UI.

## Improvements to the UI

- Mathesar now supports switching between multiple databases using the UI. _([#2847](https://github.com/mathesar-foundation/mathesar/pull/2847))_
- You can now copy data from the Mathesar UI to paste into other applications. _([#2773](https://github.com/mathesar-foundation/mathesar/pull/2773))_
- The first non-primary key column is now highlighted when a new record is created. _([#2515](https://github.com/mathesar-foundation/mathesar/pull/2515))_
- Form inputs are disabled when the form is being submitted. _([#2762](https://github.com/mathesar-foundation/mathesar/pull/2762))_
- Action pane sidebars are now resizable. _([#2808](https://github.com/mathesar-foundation/mathesar/pull/2808))_
- Table deletion now requires you to enter the table's name (to prevent accidental deletion). _([#2858](https://github.com/mathesar-foundation/mathesar/pull/2858))_
- Long table names are now truncated and the full name is shown on hover. _([#2825](https://github.com/mathesar-foundation/mathesar/pull/2825))_
- We've disabled setting columns to JSON List and Map types using the UI until we have a better editing experience for cells of those types. _([#2772](https://github.com/mathesar-foundation/mathesar/pull/2772))_
- Filter conditions can now be added and removed via the column header menu _([#2782](https://github.com/mathesar-foundation/mathesar/pull/2782))_
- Cell level context menus now also show menu items related to the row and column. _([#2803](https://github.com/mathesar-foundation/mathesar/pull/2803))_

## Improvements to installation

- We have documented additional installation options for Mathesar. Visit the [Mathesar docs site](https://docs.mathesar.org/) to explore these options. _([#2809](https://github.com/mathesar-foundation/mathesar/pull/2809) [#2826](https://github.com/mathesar-foundation/mathesar/pull/2826) [#2824](https://github.com/mathesar-foundation/mathesar/pull/2824))_
- A reference for Mathesar configuration options has been added to our documentation. _([#2824](https://github.com/mathesar-foundation/mathesar/pull/2824))_
- We have documented connecting to databases running on `localhost` outside of Docker. _([#2819](https://github.com/mathesar-foundation/mathesar/pull/2819))_
- The Mathesar Docker image is now standalone and can be started using the `docker run` command. _([#2848](https://github.com/mathesar-foundation/mathesar/pull/2848))_
- Superuser and database passwords are now validated when using the guided install script. _([#2625](https://github.com/mathesar-foundation/mathesar/pull/2625))_

## Bug fixes

- Mathesar no longer crashes when importing tables with long column names. _([#2725](https://github.com/mathesar-foundation/mathesar/pull/2725))_
- Static default values can no longer be assigned to a dynamic default column. _([#2780](https://github.com/mathesar-foundation/mathesar/pull/2780))_
- Column names no longer overlap when the browser window is resized. _([#2856](https://github.com/mathesar-foundation/mathesar/pull/2856))_
- Databases removed from the configuration environment file won't show up in the UI anymore. _([#2891](https://github.com/mathesar-foundation/mathesar/pull/2891))_
- Fixed inconsistencies with the foreign key column icon. _([#2768](https://github.com/mathesar-foundation/mathesar/pull/2768))_

## API changes

- The URL for the database page has been moved from `/<db_name>/` to `/db/<db_name>/` to avoid conflicts with other Mathesar URLs. _([#2791](https://github.com/mathesar-foundation/mathesar/pull/2791))_

## Maintenance

- A "sponsors" section has been added to the README. _([#2710](https://github.com/mathesar-foundation/mathesar/pull/2710))_

[Full Changelog](https://github.com/centerofci/mathesar/compare/0.1.1...0.1.2)
147 changes: 147 additions & 0 deletions docs/docs/releases/0.1.3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,147 @@
# Mathesar 0.1.3 (alpha release)

This release:

- makes improvements to the installation process,
- adds support for sharing tables and explorations publicly,
- begins a framework for internationalization and translation of UI elements,
- moves DDL (SQL) logic to DB-layer functions to increase performance and reduce complexity,
- Improves summarization behavior in the data explorer,
- Adds support for importing JSON and Excel files,
- fixes user-reported issues,
- improves developer experience,
- fixes numerous small backend issues,
- fixes numerous small frontend issues,
- improves the user documentation, and
- improves the API documentation.

## What's Changed

### Installation improvements

- Add superuser creation page _([#3088](https://github.com/centerofci/mathesar/pull/3088))_
- Create superuser page's stylings _([#3131](https://github.com/centerofci/mathesar/pull/3131))_
- Remove the documented steps for creating a superuser from the command line _([#3134](https://github.com/centerofci/mathesar/pull/3134))_

### Sharing tables and explorations

- Shareable links backend - Models, APIs, bypass auth for table requests _([#3092](https://github.com/centerofci/mathesar/pull/3092))_
- Shareable links frontend - shared table consumer view _([#3093](https://github.com/centerofci/mathesar/pull/3093))_
- Shared queries - Auth handling for query requests, frontend consumer view, API tests _([#3113](https://github.com/centerofci/mathesar/pull/3113))_
- UI for creating & managing shares for tables and explorations _([#3127](https://github.com/centerofci/mathesar/pull/3127))_
- Shares - regenerate link, general fixes _([#3133](https://github.com/centerofci/mathesar/pull/3133))_

### Internationalization

- Install typesafe-i18n & translates one component _([#3099](https://github.com/centerofci/mathesar/pull/3099))_
- RichText component _([#3100](https://github.com/centerofci/mathesar/pull/3100))_
- Django templates translatable _([#3101](https://github.com/centerofci/mathesar/pull/3101))_

### RSQLA1: Move DDL Operations to SQL functions

- Sql test setup _([#2903](https://github.com/centerofci/mathesar/pull/2903))_
- Add SQL for column adding _([#2923](https://github.com/centerofci/mathesar/pull/2923))_
- Move constraint creation to SQL _([#2952](https://github.com/centerofci/mathesar/pull/2952))_
- Cleaner consolidated logic for adding constraints _([#2976](https://github.com/centerofci/mathesar/pull/2976))_
- Column creation and duplication DDL 2 _([#2978](https://github.com/centerofci/mathesar/pull/2978))_
- SQL for links creation _([#2986](https://github.com/centerofci/mathesar/pull/2986))_
- Table create ddl _([#3016](https://github.com/centerofci/mathesar/pull/3016))_
- Add DDL functions for altering columns _([#3097](https://github.com/centerofci/mathesar/pull/3097))_
- SQL tests for schema ddl _([#3098](https://github.com/centerofci/mathesar/pull/3098))_
- Remove `pglast`, use SQL function instead _([#3107](https://github.com/centerofci/mathesar/pull/3107))_
- Move table splitting logic to SQL _([#3119](https://github.com/centerofci/mathesar/pull/3119))_
- Tests for links & constraints ddl _([#3120](https://github.com/centerofci/mathesar/pull/3120))_
- Properly detect identity columns _([#3125](https://github.com/centerofci/mathesar/pull/3125))_
- Wiring sql functions for links and tables _([#3130](https://github.com/centerofci/mathesar/pull/3130))_
- Tests for alter table _([#3139](https://github.com/centerofci/mathesar/pull/3139))_
- Add constraint copying to column extration logic _([#3168](https://github.com/centerofci/mathesar/pull/3168))_

### Summarization improvements

- Fix SQL Syntax error while summarizing `Money, URI, Email` column _([#2911](https://github.com/centerofci/mathesar/pull/2911))_
- Add `Sum` aggregation function _([#2893](https://github.com/centerofci/mathesar/pull/2893))_
- Add `max` aggregation function _([#2912](https://github.com/centerofci/mathesar/pull/2912))_
- Add `min` aggregation function _([#2914](https://github.com/centerofci/mathesar/pull/2914))_
- Add `mean` aggregation function _([#2916](https://github.com/centerofci/mathesar/pull/2916))_
- Add `median` aggregation function _([#2932](https://github.com/centerofci/mathesar/pull/2932))_
- Add `Mode` aggregation function _([#2940](https://github.com/centerofci/mathesar/pull/2940))_
- Add `Percentage True` aggregation function _([#2945](https://github.com/centerofci/mathesar/pull/2945))_
- Add `Peak Time` aggregation function. _([#2981](https://github.com/centerofci/mathesar/pull/2981))_
- Add `Peak Day of Week` aggregation function. _([#3004](https://github.com/centerofci/mathesar/pull/3004))_
- Add `Peak Month` aggregation function. _([#3006](https://github.com/centerofci/mathesar/pull/3006))_
- Fix `NaN:NaN` error while aggregating duration column _([#3136](https://github.com/centerofci/mathesar/pull/3136))_

### JSON and Excel file improvements

- Updated datafile model to store file type _([#2890](https://github.com/centerofci/mathesar/pull/2890))_
- Added methods to import a perfect JSON _([#2906](https://github.com/centerofci/mathesar/pull/2906))_
- Removed code duplication while importing datafiles _([#2926](https://github.com/centerofci/mathesar/pull/2926))_
- Added tests to check importing json feature _([#2933](https://github.com/centerofci/mathesar/pull/2933))_
- Added pandas and JSON normalization code _([#2968](https://github.com/centerofci/mathesar/pull/2968))_
- Added api tests for importing JSON feature _([#2977](https://github.com/centerofci/mathesar/pull/2977))_
- Added documentation for importing data into tables _([#2992](https://github.com/centerofci/mathesar/pull/2992))_
- Extended import via copy-paste for JSON and updated UI _([#3008](https://github.com/centerofci/mathesar/pull/3008))_
- Updated documentation navigation to show importing data doc _([#3023](https://github.com/centerofci/mathesar/pull/3023))_
- Added `max_level` param for JSON import feature in the backend _([#3039](https://github.com/centerofci/mathesar/pull/3039))_
- Added functionality to import perfect Excel _([#3059](https://github.com/centerofci/mathesar/pull/3059))_

### Fixes for user-reported issues

- Help text: "its linked tables" (possessive adjective) _([#3086](https://github.com/centerofci/mathesar/pull/3086))_

### DX improvements

- Remove `.env` from developer guide. _([#2925](https://github.com/centerofci/mathesar/pull/2925))_
- Add SQL files to the pytest workflow _([#3082](https://github.com/centerofci/mathesar/pull/3082))_
- New linting rule _([#3116](https://github.com/centerofci/mathesar/pull/3116))_
- Repeat failed tests _([#3118](https://github.com/centerofci/mathesar/pull/3118))_
- Add pldebugger to dev db _([#3126](https://github.com/centerofci/mathesar/pull/3126))_

### Backend fixes and improvements

- Fix migrations _([#2899](https://github.com/centerofci/mathesar/pull/2899))_
- Remove lazydict dependency _([#2993](https://github.com/centerofci/mathesar/pull/2993))_
- Add API tests for multi-column primary key constraints _([#3025](https://github.com/centerofci/mathesar/pull/3025))_
- Support unknown types (backend) _([#3040](https://github.com/centerofci/mathesar/pull/3040))_
- Allow usage of local.py for untracked settings _([#3064](https://github.com/centerofci/mathesar/pull/3064))_
- Fix the error when `list aggregation` on mathesar custom array _([#3106](https://github.com/centerofci/mathesar/pull/3106))_
- Merge db list demo mode commits into release 0.1.3 _([#3171](https://github.com/centerofci/mathesar/pull/3171))_

### Frontend fixes and improvements

- Schema updates in database page without reloading. Fixes #2736 _([#2745](https://github.com/centerofci/mathesar/pull/2745))_
- Make columns re-orderable _([#2831](https://github.com/centerofci/mathesar/pull/2831))_
- Fix caret out of view when using Input on Chrome _([#2836](https://github.com/centerofci/mathesar/pull/2836))_
- Improve TSV serialization when copying cells _([#2867](https://github.com/centerofci/mathesar/pull/2867))_
- Add `max_split=1` to retrieve the column name _([#2956](https://github.com/centerofci/mathesar/pull/2956))_
- Fix default value input stealing focus _([#2957](https://github.com/centerofci/mathesar/pull/2957))_
- Auto-focus input when editing number/money cells _([#2975](https://github.com/centerofci/mathesar/pull/2975))_
- Updated frontend to send a single bulk delete request instead of one request for each record _([#2985](https://github.com/centerofci/mathesar/pull/2985))_
- Added margin between breadcrumb selector and bottom of the veiwport _([#3014](https://github.com/centerofci/mathesar/pull/3014))_
- Date Input closes now on tab _([#3038](https://github.com/centerofci/mathesar/pull/3038))_
- Scroll sheet all the way down when clicking the New Record button _([#3045](https://github.com/centerofci/mathesar/pull/3045))_
- Use Truncate component in Record Selector table cells _([#3077](https://github.com/centerofci/mathesar/pull/3077))_
- Copy formatted cell values to clipboard instead of raw values _([#3094](https://github.com/centerofci/mathesar/pull/3094))_
- Fix regression: Move UserProfile to the App level context from Route level context _([#3175](https://github.com/centerofci/mathesar/pull/3175))_


### Documentation

- Update README.md with troubleshooting instructions _([#2751](https://github.com/centerofci/mathesar/pull/2751))_
- Update documentation styles for active and hover _([#2937](https://github.com/centerofci/mathesar/pull/2937))_
- Added the command that generates the API documentation schema file to… _([#2970](https://github.com/centerofci/mathesar/pull/2970))_
- Added the command to copy the .env file, to the DEVELOPER GUIDE _([#2972](https://github.com/centerofci/mathesar/pull/2972))_
- Update demo's documentation _([#2996](https://github.com/centerofci/mathesar/pull/2996))_
- Fix typo error in DEVELOPER_GUIDE.md _([#2999](https://github.com/centerofci/mathesar/pull/2999))_
- Update build from source documentation _([#3029](https://github.com/centerofci/mathesar/pull/3029))_
- Clean up import docs _([#3042](https://github.com/centerofci/mathesar/pull/3042))_

### API documentation

- Integrated drf-spectacular library _([#2939](https://github.com/centerofci/mathesar/pull/2939))_
- Improved the operationIds by implementing a post hook function _([#3021](https://github.com/centerofci/mathesar/pull/3021))_
- Added OpenAPI spec for datafiles endpoint _([#3044](https://github.com/centerofci/mathesar/pull/3044))_
- Added OpenAPI specification for databases endpoint _([#3047](https://github.com/centerofci/mathesar/pull/3047))_
- Added OpenAPI specification for /schemas/ endpoint _([#3074](https://github.com/centerofci/mathesar/pull/3074))_

[Full Changelog](https://github.com/centerofci/mathesar/compare/0.1.2...0.1.3)
5 changes: 5 additions & 0 deletions docs/mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,11 @@ nav:
- Syncing database changes: user-guide/syncing-db.md
- Users & access levels: user-guide/users.md
- Glossary: user-guide/glossary.md
- Releases:
- '0.1.3': releases/0.1.3.md
- '0.1.2': releases/0.1.2.md
- '0.1.1': releases/0.1.1.md
- '0.1.0': releases/0.1.0.md

plugins:
- search:
Expand Down
Loading