Skip to content

chore: Documentation updates and cleaning up root folder #117

Merged
bartoszmajsak merged 2 commits intomainfrom
readme-update
Oct 3, 2025
Merged

chore: Documentation updates and cleaning up root folder #117
bartoszmajsak merged 2 commits intomainfrom
readme-update

Conversation

@jland-redhat
Copy link
Copy Markdown
Contributor

@jland-redhat jland-redhat commented Oct 1, 2025

Moving some files around to help clean up our root directory. And updating the README to remove out of date information, and also help the user more quickly get to the the deployment guide.

Going to update deployment guides in followup PRs

Summary by CodeRabbit

  • Documentation
    • Overhauled README to emphasize OpenShift/KServe, update prerequisites, remove Features/Architecture, retire one-command quick starts, simplify dev/deploy guidance, rework documentation links (Local Deployment, OAuth Setup), update access/usage examples, and remove acknowledgments.
    • Updated Quick Setup Script path reference to scripts/create-my-env.sh.
    • Added apps/README.md section introducing the frontend with a WIP notice and placeholder deployment notes.
    • Added docs/LOCAL_DEPLOYMENT.md with a WIP placeholder for local deployment instructions.

…ate information, as well as moving files out of our root directory to help tidy up a little bit
@jland-redhat jland-redhat requested a review from noyitz October 1, 2025 20:56
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Oct 1, 2025

Important

Review skipped

Review was skipped as selected files did not have any reviewable changes.

💤 Files selected but had no reviewable changes (6)
  • apps/scripts/cleanup-env.sh
  • apps/scripts/create-my-env.sh
  • apps/scripts/start-backend.sh
  • apps/scripts/start-dev.sh
  • apps/scripts/start-frontend.sh
  • apps/scripts/stop-dev.sh

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Walkthrough

Documentation was overhauled: the root README was rewritten to shift focus to OpenShift/KServe and simplified sections; quick-start and architecture content were removed; links and prerequisites were updated. App-level docs were adjusted for a script path change and a WIP frontend note. A new WIP local deployment doc was added.

Changes

Cohort / File(s) Summary
Root README overhaul
README.md
Reframed stack to emphasize OpenShift/KServe; removed Features, Architecture, Quick Start, and Acknowledgments; updated prerequisites and links; adjusted access/usage references; restructured documentation pointers (e.g., Local Deployment, OAuth Setup).
Apps docs updates
apps/README-create-env.md, apps/README.md
Updated quick setup script path to scripts/create-my-env.sh; added frontend app WIP note with placeholder deployment guidance.
Local deployment docs
docs/LOCAL_DEPLOYMENT.md
Added new Local Deployment doc with WIP placeholder.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

I nibbled the docs, trimmed the fluff,
Hop to OpenShift—that’s enough!
KServe carrots stacked in rows,
Local burrow guide still grows.
Scripts moved burrow-left, you’ll see—
WIP fields, but soon we’ll spree! 🥕🐇

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Title Check ⚠️ Warning The title “Updated the main README to reduce what was shown, and remove out of d…” loosely describes that the main README was changed but uses vague language like “reduce what was shown” and is truncated, which obscures the intent and clarity of the primary change. Please refine the title to a concise, single sentence that clearly summarizes the main change without vague phrases or truncation, for example: “Simplify main README by removing outdated sections and reorganizing docs.”
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@jland-redhat jland-redhat changed the title Updated the main README to reduce what was shown, and remove out of d… chore: Documentation updates and cleaning up root folder Oct 2, 2025
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't the README file in docs/ sufficient for explaining local deployment? Maybe just reference it? Or you have a greater idea for a separate set of instructions in this file? #_#

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think our docs are going to grow overtime and it tends to get messy when you don't have a cordoned off place for them.

See the lllama stack repo for an example of what I mean:
https://github.com/llamastack/llama-stack/tree/main/docs

We can also eventually create a workflow that deploys a documents page for us, similar to this created from the docs folder above:
https://llama-stack.readthedocs.io/en/latest/

So in short the "greater idea" thing

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we can just remove it until we have something concrete to share? Brings back memories of "website under construction" :)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah my thought here was more of trying to start the outline of what our docs would actually look like. But we can just remove this for now.

@dmytro-zaharnytskyi dmytro-zaharnytskyi self-requested a review October 2, 2025 15:13
Copy link
Copy Markdown
Collaborator

@dmytro-zaharnytskyi dmytro-zaharnytskyi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wunderbar

Copy link
Copy Markdown
Collaborator

@bartoszmajsak bartoszmajsak left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@noyitz
Copy link
Copy Markdown
Collaborator

noyitz commented Oct 3, 2025

LGTM

Copy link
Copy Markdown
Collaborator

@noyitz noyitz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@bartoszmajsak bartoszmajsak merged commit a609675 into main Oct 3, 2025
2 checks passed
@bartoszmajsak bartoszmajsak deleted the readme-update branch October 3, 2025 09:13
SB159 pushed a commit to SB159/maas-billing that referenced this pull request Oct 15, 2025
…-io#117)

* Updated the main README to reduce what was shown, and remove out of date information, as well as moving files out of our root directory to help tidy up a little bit

* Addressing comments

---------

Co-authored-by: Jamie Land <hokie10@gmail.com>
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.

5 participants