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

Writing Quick Start instructions #10

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

Conversation

SpiccyMayonnaise
Copy link
Contributor

Addresses #9.

I have provided an initial attempt at writing the Quick Start section of the documentation to illustrate how to build the templates.

I'd love to get your feedback on this so far and work with you in this PR to fill out more of the README.

@vbe0201
Copy link
Owner

vbe0201 commented Jan 24, 2022

Hello, thank you for helping out with the README, it's much appreciated! I've been meaning to write it for ages but never really had time and eventually lost track of it.

So far this is looking very good. What I would personally add to the quickstart section is a reference to the CMake documentation explaining toolchain files and some instructions for helping users set this up for their own projects, especially when they're rather new to CMake in general (which we kind of assume by explicitly mentioning the CMake download?).

That is, having to add the cmake/ directory and the toolchain file to the root of a project and subsequently building with the --toolchain flag. For autocompletion in IDEs like CLion, It might also be noteworthy to mention the addition of the -DCMAKE_TOOLCHAIN_FILE=DevkitA64Libnx.cmake option to CMake toolchain settings.

On a more general note, I'd like to suggest that we populate the readme in "batches" across multiple PRs so you don't have to do everything yourself and your efforts on this PR are not wasted in case you eventually lose interest in this. #9 could be used to track who is currently writing what.

@SpiccyMayonnaise SpiccyMayonnaise changed the title Improve project documentation. Writing Quick Start instructions Jan 25, 2022
@SpiccyMayonnaise
Copy link
Contributor Author

Hi, I've put a small description regarding the arguments passed to cmake when building. Hopefully this covers things.

Regarding the command arguments for cmake toolchain, I'm not sure what the difference is between --toolchain and -D CMAKE_TOOLCHAIN_FILE, since CLion gives me autocomplete either way. I'll admit I'm still pretty inexperienced with CMake and C/C++ development as a whole, but I'll try my best to help out! :)

Perhaps it could be worth writing a second set of instructions for building with CLion, since that's probably a big reason to use this project.

I agree in breaking up the task of writing the README, I have retitled this PR to reflect this.

@szymonj99
Copy link

Just wondering since this seems to be 'stale'. What's the hold up on this? Cheers! 👍

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