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

Update deployment docs #2589

Closed
19 tasks done
kgodey opened this issue Feb 27, 2023 · 0 comments
Closed
19 tasks done

Update deployment docs #2589

kgodey opened this issue Feb 27, 2023 · 0 comments
Assignees
Labels
ready Ready for implementation restricted: maintainers Only maintainers can resolve this issue type: enhancement New feature or request work: documentation Improvements or additions to documentation work: other

Comments

@kgodey
Copy link
Contributor

kgodey commented Feb 27, 2023

General tasks

  • Add more info on connecting existing databases
  • Consider including Ansible playbooks to set up OS with Docker
  • Consider integrating Windows guide (written by Ben)

Usability tests - feedback

  • Add wget to prerequisites. It's not there by default on Debian. - tracked in Installation issues on a Debian 11 server #2572
  • Add more detail about how to achieve a "clean Docker state" will be handled by Create uninstall documentation #2585
  • Add more explanation/justification around sudo use by script - done in previous updates
  • Set /etc/mathesar to the default for copy/pasting start/stop commands.
  • List operating systems on which we have tested Mathesar
  • Emphasize that Mathesar is alpha software and issues should be opened on GitHub
  • Issues from WB testing report
    • Rename "Installl with Docker Compose" to just "Installation"
    • Swap positions of start/stop Mathesar commands
    • Improve precision of Database Configuration step
    • Improve precision of Webserver Configuration step
    • Add recommended permissions to Configuration directory step
    • Fix typo in Docker containers section
    • Ports section
@kgodey kgodey added type: enhancement New feature or request status: triage labels Feb 27, 2023
@kgodey kgodey self-assigned this Feb 27, 2023
@kgodey kgodey added work: documentation Improvements or additions to documentation work: other ready Ready for implementation restricted: maintainers Only maintainers can resolve this issue and removed status: triage labels Feb 27, 2023
@kgodey kgodey changed the title Installation usability test - docs medium priority issues Installation usability test - issues with docs Feb 27, 2023
@kgodey kgodey changed the title Installation usability test - issues with docs Update Mathesar docs Feb 27, 2023
@kgodey kgodey changed the title Update Mathesar docs Update deployment docs Feb 27, 2023
@kgodey kgodey mentioned this issue Feb 28, 2023
7 tasks
@kgodey kgodey closed this as completed Mar 1, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ready Ready for implementation restricted: maintainers Only maintainers can resolve this issue type: enhancement New feature or request work: documentation Improvements or additions to documentation work: other
Projects
No open projects
Development

No branches or pull requests

1 participant