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 update: Explain what makes ahkpm useful #142

Open
hwayne opened this issue Nov 14, 2022 · 3 comments
Open

Documentation update: Explain what makes ahkpm useful #142

hwayne opened this issue Nov 14, 2022 · 3 comments
Labels
documentation Improvements or additions to documentation
Milestone

Comments

@hwayne
Copy link

hwayne commented Nov 14, 2022

Most AHK users haven't heard of a package manager before. What does this do for them? Is this for getting new APIs and libraries, or for getting new useful scripts? Or both?

What would help a lot: an example of several actual packages you can download with this. Is there one for JSON? For controlling monitors?

@joshuacc joshuacc added this to the 0.6.0 milestone Nov 15, 2022
@joshuacc joshuacc added the documentation Improvements or additions to documentation label Nov 15, 2022
@joshuacc
Copy link
Owner

joshuacc commented Nov 15, 2022

That's a really great point. I tried to get a bit of that across on the ahkpm.dev homepage, but it's definitely not enough.

From your comments I envision at least three pieces of work:

  • Provide more "Why is this useful?" information on the front page
  • Have an introduction with more details on why it's useful (more than the front page can reasonably provide)
  • Have a full tutorial walking through using ahkpm to develop a script, showing off how to use some things like the following:
    • G33kDude/Chrome.ahk for scripting a browser
    • Chunjee/json.ahk for working with JSON
    • davebrny/ezMenu for building menus

Thanks so much for the feedback!

@joshuacc
Copy link
Owner

FWIW, there is now a "packages" page which should help a bit with the packages discovery. Still lots to do, but at least there are concrete examples of packages there. https://ahkpm.dev/packages/

@joshuacc joshuacc modified the milestones: 0.6.0, 0.7.0 Nov 21, 2022
@joshuacc
Copy link
Owner

@hwayne What do you think of the documentation after the latest round of updates? There's a bit more info on the front page, and a much more fleshed out introduction, among other things.

@joshuacc joshuacc modified the milestones: 0.7.0, 0.8.0 Dec 4, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants