-
Notifications
You must be signed in to change notification settings - Fork 84
Would love help with README to walk users through first commit #1
Comments
alright i will help |
how can i help |
Would love it if you read through the README, followed the instructions so far, and made any suggestions on what you think might fit in next steps. Especially any ideas on how to finish the rest of the Pull Request process without the use of the command line. |
Alright |
Thanks |
how do you open it in vs code |
You can clone from vs code with the command template. I'm going offline for the next 10 hours, but I can give more details tomorrow. Thank you so much for your interest! |
okay |
thanks |
Why avoid the command line? If you're developing, you're going to be using it at some point, so why not get aquainted with it? I can make a pretty good guide for that if needed. If you're sticking to your wish to make it command line free, I would also recommend a tool kalled gitkraken. That piece of software is amazing for git. |
@redxtech I love the command line (and gitkraken), I just worry that it might not be straight-forward enough to follow for someone who has never used it before. I was also thinking that keeping things inside of an application would make the guide identical regardless of mac or pc. If you think we can make a pretty good guide for that (for windows and mac) I'm all ears. |
I see your point, however, the command line is the exact same (in terms of git) accross macOS, Windows, and linux. Additionally, not all people use VS Code. For one, the git on the command line has the least amount of software needed to be installed in order to be fully functional. Something that would be another idea would be to make a multi part guide, with a section dedicated to each seperate piece of software. (initial page for command line, additional page for gitkraken, extra one for, VS code, for github desktop, for IDEA IDE's, for atom, etc) That way, people can get the basics of how to use the command line (if their preferred software is unavailable for some reason) and then they can choose the platform based on what fits their workflow the best. |
I like that a lot. I think for the first run through I want to be very prescriptive on what to do (more on the side of "here is one way to do it" and less "here are seven ways to do it" which can lead to paralysis. The more research I've done, the less it seems possible to do things without the command line. If you want to take a stab at writing the documentation, I'd love to include it @redxtech |
Sure, will do! |
That sounds perfect @redxtech! |
Ok, I'll get started on that :) |
I'm currently in the middle of writing this, but I really like the shadow you have on your images. Once I upload those can you edit these ones to have the same look? |
Thanks! That is default behavior with full screen screen shots on Mac ( |
Ah I see. I can get the screenshots on my Mac then. |
This is looking really good @redxtech! Thank you so much! I do have a few questions:
I think this is a really solid foundation, but I think there are a lot of places for a person just learning about the command line and git for the first time to make mistakes here. The target audience for this repo is people who have never used git or the command line before. That said, what you've created is way better than what we have now, so I'll gladly merge when you're ready and we can make gradual improvements over time. After all, that's the whole point of git 😃 |
Ah, thanks for the comments. I didn't even think of any of those. This is my first time writing a guide like this, so if you have any more comments please let me know. I'm going through the entire guide looking for things that I may have overlooked, and fixing those as well. Also don't worry about a lack of images, those will be added as well. |
No problem! Thank you for all of the effort you're putting into this! |
Just submitted a PR for the guide. Let me know if there's anything that needs changing. |
I will certainly go through this in the next day or so and get some interview questions up. I think this project in general is a huge help for those new to GIT or GITHUB. |
Thanks @izulien! That's what we're hoping for! We can always get better! |
I will go through the README and clarify some things that are a bit confusing. |
Thanks @Lysautumn! I reviewed the changes and with the exception of one small grammatical issue, it looks good! |
We are trying to make a website (plain html and css) that helps walk users through their first commit with an IDE. I tried simplifying things down, and thanks to Visual Studio Code's ability to clone a repository down from the application, I have gotten pretty far without the user needing to use the command line, but I've hit a point with being able to push where I don't know how to do it without the command line.
My biggest concern is that for a brand new user, the command line is a pretty big and intimidating beast, so I would like to do it without that. Any ideas or suggestions? Feel free to make a PR to the README.md if you have an idea.
I have also provided images up to that point (and am able/willing to produce them after that point) if someone has ideas. The biggest thing about not using the command line (besides the learning curve) is that if I can keep everything in Github and Visual Studio Code, then I don't need to write separate examples for Mac and PC and can still be inclusive.
The text was updated successfully, but these errors were encountered: