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

docs: Improve Linux installation documentation #1094

Open
wants to merge 13 commits into
base: main
Choose a base branch
from

Conversation

atxtechbro
Copy link

This PR enhances the Linux installation documentation by:

  • Adding desktop environment integration instructions for AppImage users
  • Providing a complete example for creating desktop shortcuts
  • Improving the overall user experience for Linux installations

These changes help Linux users better integrate Amazon Q into their workflow and desktop environments.

I acknowledge that by submitting this pull request, I am contributing code to an AWS open source project and agree to the terms of the project's licensing.

🤖 Assisted by Amazon Q Developer

- Add cli.png to docs/assets for GitHub Pages favicon
- Update book.toml with GitHub Pages configuration
- Complete Linux installation instructions for Ubuntu/Debian and AppImage

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
- Comment out fork restrictions to enable testing on forked repos
- This change allows testing the GitHub Pages deployment before merging

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
- Configure workflow to run on pushes to docs/fix-github-pages branch
- This allows testing the GitHub Pages deployment directly from the feature branch

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
- Replace verbose onboarding steps with simple 'q login' command
- Improve clarity and conciseness of getting started section
- Maintain all installation instructions and support information

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
- Remove the cli.png file that was causing issues with GitHub Pages
- This file will need to be provided by maintainers with proper branding

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
- Comment out the favicon configuration in book.toml
- This prevents GitHub Pages build errors due to missing image
- Maintainers can uncomment and provide proper image later

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
- Remove book.toml to test if GitHub Pages still deploys without it
- This is an experimental change to understand the deployment process

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
- Restore the original book.toml from the main branch
- Remove only the favicon configuration that was causing issues
- This keeps the essential mdBook configuration intact

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
docs: Restore original book.toml without favicon config
- Restore the original workflow configuration from the upstream repository
- Remove custom branch triggers that were added for testing
- Re-enable the fork check to prevent deployment from forks

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
ci: Reset GitHub Pages workflow to match upstream
@atxtechbro atxtechbro requested a review from a team as a code owner April 5, 2025 03:41
Replace Ubuntu/Debian and AppImage installation methods with direct
download instructions for x86-64 and ARM architectures to simplify
the installation process.

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
@codecov-commenter
Copy link

codecov-commenter commented Apr 8, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 13.69%. Comparing base (1070cb4) to head (f1d80a4).
Report is 21 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1094      +/-   ##
==========================================
- Coverage   13.84%   13.69%   -0.16%     
==========================================
  Files        2371     2361      -10     
  Lines      205096   203706    -1390     
  Branches   185460   184070    -1390     
==========================================
- Hits        28398    27890     -508     
+ Misses     175267   174427     -840     
+ Partials     1431     1389      -42     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@brandonskiser
Copy link
Contributor

Thanks for the contribution! Just a couple changes

Address PR feedback by:
- Using install.sh script instead of manually moving binary
- Restoring the Builder ID vs IAM Identity Center note as a block quote

🤖 Assisted by [Amazon Q Developer](https://aws.amazon.com/q/developer)
@atxtechbro atxtechbro requested a review from brandonskiser April 9, 2025 00:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants