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

[Documentation] New README for clear information for developers and users #56

Draft
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

kevin-wijnen
Copy link

@kevin-wijnen kevin-wijnen commented Mar 17, 2024

Context

The Decky Plugin Store repository currently lacks the documentation for showing which tech has been used, what is necessary to run a self-hosted Decky Loader plugin storefront and pointers where to look for making modifications for those self-hosted storefronts.

The Decky Loader repository has a more comprehensive README which shows the featureset, common issues and installation instructions.

Proposal

My Pull Request tries to close the gap between both repositories regarding documentation in the README file by making the following changes:

  • Mentioning more specifics regarding the used tech along with hyperlinks pointing to relevant code or documentation.
  • Mentioning the featureset (customisable frontend, endpoints, cloud storage, webhook, package options) for developers to get a clearer view what is currently possible with the storefront code.
  • Clear installation instructions for using a custom store with Decky Loader.
  • Clear installation instructions how to deploy the project with Docker, including prequesities for self-hosting the store.
  • Mentioning possible future changes (PostgreSQL support, third party plugin & repository warnings) noteworthy to developers.
  • Stylise it as much as possible with the Decky Loader's README style.

While there are some fields untouched (e.g.: how to customise Decky Store's tag system to add more tags in the plugin browser, rate limiting per plugin), I do hope this will help developers and "self-hosted store hosters" alike to bring more Decky plugin stores to the public.

I'm unable to run a local environment due to the lack of Backblazer environment, so I'd hope some maintainers of the Decky Plugin Store or of any custom store could help out with suggestions and verifying the contents of the README to make it useful for developers.

TODOs

  • Stylise it to align more with the Decky Loader README:
    • Screenshot of a custom storefront
    • Statistics buttons
    • Using Steam & Decky Loader button icons for clearer user instructions
  • Adding extra relevant developer information (possible suggestions:)
    • Customising plugin store tags
    • Customising certain web pages to distinguish more from the official Decky Loader store channels
    • Common Issues
    • Clearer contribution instructions akin to Decky Loader's README

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.

1 participant