reorganize the doc and add a documentation section

Author: Anish9901

docs/docs/releases/0.1.6.md

@@ -12,25 +12,52 @@ See our guide on [upgrading Mathesar to 0.1.6](../administration/upgrade/0.1.6.m
 
 ## Improvements
 
-- Mathesar is now compatible with Python versions: 3.10 and 3.11 along with 3.9 _[#3478](https://github.com/mathesar-foundation/mathesar/pull/3478)_
-- Added support for Japanese translations _[#3486](https://github.com/mathesar-foundation/mathesar/pull/3486)_, _[#3484](https://github.com/mathesar-foundation/mathesar/pull/3484)_, _[#3483](https://github.com/mathesar-foundation/mathesar/pull/3483)_, _[#3472](https://github.com/mathesar-foundation/mathesar/pull/3472)_
-- NodeJS is no longer a requirement for building Mathesar from source _[#3489](https://github.com/mathesar-foundation/mathesar/pull/3489)_ 
-- Text fields now auto-expands on the record page to accommodate longer texts _[#3470](https://github.com/mathesar-foundation/mathesar/pull/3470)_
+### You can now configure Mathesar's UI to display in Japanese
 
-## Bug fixes
+The language setting is stored per-user and can be modified when logging in or    when editing a user. This changes the text displayed on buttons and other UI elements within Mathesar. It does not change the display of data within your database (e.g. table names, column names, and cell values). We are hoping to support more languages beyond English and Japanese eventually. Please reach out to us if your are interested in helping to add more translations! 
+    
+_[#3486](https://github.com/mathesar-foundation/mathesar/pull/3486 "Enable i18n")_, _[#3484](https://github.com/mathesar-foundation/mathesar/pull/3484 "Updates for file translations/en/LC_MESSAGES/django.po in ja")_, _[#3483](https://github.com/mathesar-foundation/mathesar/pull/3483 "Updates for file mathesar_ui/src/i18n/languages/en/dict.json in ja")_, _[#3472](https://github.com/mathesar-foundation/mathesar/pull/3472 "Separate pluralized string to fix Transifex sync")_, _[#3501](https://github.com/mathesar-foundation/mathesar/pull/3501 "Fix layout problem in Data Explorer actions pane")_
 
-- Fixed record selector filtering bug _[#3488](https://github.com/mathesar-foundation/mathesar/pull/3488)_
-- Fixed connection creation failures due to schema name collisions while adding provided sample schema(s) in the database _[#3490](https://github.com/mathesar-foundation/mathesar/pull/3490)_
-- Fixed height inconsistencies of record selector's text inputs _[#3495](https://github.com/mathesar-foundation/mathesar/pull/3495)_
-- Fixed CSRF failures when the app is behind a reverse proxy _[#3499](https://github.com/mathesar-foundation/mathesar/pull/3499)_
-- Fixed layout issues while using Japanese translations _[#3501](https://github.com/mathesar-foundation/mathesar/pull/3501)_
+### Text fields now auto-expands on the record page to accommodate longer texts
+
+**Before**
+
+All text inputs on the record page had the same height, regardless of their content.
+
+**After**
+
+All text inputs in record page dynamically adjust to accommodate the content seamlessly.
+
+_[#3470](https://github.com/mathesar-foundation/mathesar/pull/3470 "Make textarea inputs auto-expand to accommodate longer text fields on the record page")_, _[#3488](https://github.com/mathesar-foundation/mathesar/pull/3488 "Fix regression with record selector not filtering")_, [#3495](https://github.com/mathesar-foundation/mathesar/pull/3495 "Prevent record selector inputs from growing taller")
+
+### Mathesar is now compatible with Python versions: 3.10 and 3.11 along with 3.9
+Mathesar now officially supports Python versions 3.10 and 3.11, in addition to the existing 3.9 compatibility. This will provide great flexibilty while building Mathesar from source on an OS that natively ships with relatively newer versions of Python.
+_[#3478](https://github.com/mathesar-foundation/mathesar/pull/3478 "Extend mathesar to support python 3.10 and above")_, _[#3499](https://github.com/mathesar-foundation/mathesar/pull/3499 "Fix CSRF failures when app is behind a reverse proxy")_, _[#3503](https://github.com/mathesar-foundation/mathesar/pull/3503 "Remove 3.12 support from docs")_, [#3504](https://github.com/mathesar-foundation/mathesar/pull/3504 "Parameterize dev service python version")
+
+### Mathesar is now compatible with PostgreSQL 16
+Mathesar now officially supports, and is tested against, Postgres versions 13, 14, 15 and 16.
+_[#3480](https://github.com/mathesar-foundation/mathesar/pull/3480 "Add PG 16 to testing matrix")_
+
+### NodeJS is no longer a requirement for building Mathesar from source
+
+_[#3489](https://github.com/mathesar-foundation/mathesar/pull/3489 "GH workflow to create draft release with built static files")_ 
+
+## Bug fix
+
+- Fixed connection creation failures due to schema name collisions while adding provided sample schema(s) in the database _[#3490](https://github.com/mathesar-foundation/mathesar/pull/3490 "Fix schema creation errors while adding a new connection")_
+
+## Documentation
+
+- Documented upgrade instructions for v0.1.6 _[#3507](https://github.com/mathesar-foundation/mathesar/pull/3507 "Adds upgrade documentation for 0.1.6, fixes existing issues with upgrade docs")_
+- Documented mathesar-debug image for Docker based installations _[#3513](https://github.com/mathesar-foundation/mathesar/pull/3513 "Add Debug image docs")_
+- Fixed upgrade instructions for v0.1.5 _[#3469](https://github.com/mathesar-foundation/mathesar/pull/3469 "Merge pull request #3468 from mathesar-foundation/upgrade_instruction_fix")_
+- Updated Mathesar's version number in docs _[#3476](https://github.com/mathesar-foundation/mathesar/pull/3476 "Merge pull request #3475 from mathesar-foundation/version_number_in_docs")_
 
 ## Maintenance
 
-- Added a health check endpoint for Mathesar _[#3479](https://github.com/mathesar-foundation/mathesar/pull/3479)_
-- Added Postgres 16 to testing matrix _[#3480](https://github.com/mathesar-foundation/mathesar/pull/3480)_
-- Added MkDocs edit URI _[#3482](https://github.com/mathesar-foundation/mathesar/pull/3482)_
-- Bumped Django from 4.2.8 to 4.2.10 _[#3492](https://github.com/mathesar-foundation/mathesar/pull/3492)_
-- Removed stale code coverage badge _[#3491](https://github.com/mathesar-foundation/mathesar/pull/3491)_
-- Removed NodeJS from Docker production image _[#3474](https://github.com/mathesar-foundation/mathesar/pull/3474)_ 
-- Improved Docker development image to allow switching between Python versions _[#3504](https://github.com/mathesar-foundation/mathesar/pull/3504)_
+- Added a health check endpoint for Mathesar _[#3479](https://github.com/mathesar-foundation/mathesar/pull/3479 "Add health check endpoint to Mathesar")_
+- Bumped Django from 4.2.8 to 4.2.10 _[#3492](https://github.com/mathesar-foundation/mathesar/pull/3492 "Bump django from 4.2.8 to 4.2.10")_
+- Removed NodeJS from Docker production image _[#3474](https://github.com/mathesar-foundation/mathesar/pull/3474 "Add multiple stages to Dockerfile, remove NodeJS & unnecessary source files from production image")_ 
+- Added MkDocs edit URI _[#3482](https://github.com/mathesar-foundation/mathesar/pull/3482 "Added MkDocs edit URI")_
+- Removed stale code coverage badge _[#3491](https://github.com/mathesar-foundation/mathesar/pull/3491 "Remove stale code coverage badge")_
+- Post release cleanup _[#3463](https://github.com/mathesar-foundation/mathesar/pull/3463 "Merge pull request #3460 from mathesar-foundation/0.1.5")_