From f477d7bebca74f53dacf1eb5e3557698bf96462c Mon Sep 17 00:00:00 2001 From: Craig Oates Date: Sat, 30 Sep 2017 00:43:58 +0100 Subject: [PATCH] Added Images to README.md, - Added links to CONTRIBUTING.md - Spelling and grammar changes pages above. The documents still need more proof reading and editing. With that said, the guides are the only significant thing left to add to this project. Once that is done, it will mostly be a case of fine tuning stuff for version 1.0. --- CONTRIBUTING.md | 61 +++++++----------- .../CW_Console/ConsoleCommands.cs | 2 +- .../README_Assets/README_Invalid_Input.png | Bin 0 -> 56226 bytes .../README_Assets/README_Method_Mapping.gif | Bin 0 -> 23836 bytes .../README_Method_Mapping_Invalid.gif | Bin 0 -> 38491 bytes .../README_Assets/README_Valid_Input.png | Bin 0 -> 22776 bytes README.md | 59 ++++++++++------- 7 files changed, 61 insertions(+), 61 deletions(-) create mode 100644 Documentation/README_Assets/README_Invalid_Input.png create mode 100644 Documentation/README_Assets/README_Method_Mapping.gif create mode 100644 Documentation/README_Assets/README_Method_Mapping_Invalid.gif create mode 100644 Documentation/README_Assets/README_Valid_Input.png diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a6c8d9a..793b64d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,17 +2,17 @@ Let me begin by saying thank you for stopping by and checking out Console.Waterworks. -The following is a set of guidelines for contributing to Console.Waterworks. I must stress, though, these are guidelines and nothing more. They are not set in stone. Please feel free to use your own judgement when contributing. +The following is a set of guidelines for contributing to Console.Waterworks. I must stress, though, they are guidelines and nothing more. They are not set in stone. Please feel free to use your own judgement when contributing. ## Code of Conduct -The Console.Wateworks Code of Conduct governs every participant of this project. If you decide to take part in developing in cultivating the project, the expectation is for you to adhere to it. +The [Console.Waterworks Code of Conduct](https://github.com/CraigOates/Console.Waterworks/blob/develop/CODE_OF_CONDUCT.md, "Code of Conduct") governs every participant of this project. If you decide to take part in developing and cultivating the project, the expectation is you to adhere to it. -Please report any unacceptable behaviour to craig@craigoates.net. +Please report any unacceptable behaviour to [craig@craigoates.net](craig@craigoates.net, "Craig's email address"). ## The Creator's Expectations for Console.Waterworks -To those who do not know, Console.Waterworks is the creation of Craig Oates (A.K.A. me [GitHub Profile link]). I am a person, like you, and I argue it is important you know a bit about me. The reason why this is important is because it will help you gauge if this project is for you. I do not want you to feel frustrated when working on Console.Waterwork due to people problems. I know I cannot foresee every problem and counteract it. But, I can let you know the type of person I am and what I expect from the project. This will help you gauge the likelihood of us having conflicting personalities. And, it will highlight any differences in perspectives sooner -- if all goes as intended. +To those who do not know, Console.Waterworks is the creation of Craig Oates (A.K.A. [me](http:github.com/CraigOates, "Craig's GitHub Profile")). I am a person, like you, and I argue it is important you know a bit about me. The reason why this is important is because it will help you gauge if this project is for you. I do not want you to feel frustrated when working on Console.Waterworks due to people problems. I know I cannot foresee every problem and counteract it. But, I can let you know the type of person I am and what I expect from the project. This will help you gauge the likelihood of us having conflicting personalities. And, it will highlight any differences in perspectives sooner -- if all goes as intended. If it does look like we have a miss-match at the person level, I would like to take a moment and say one thing. It is okay -- we do not all think alike. You will face no hard feelings from me and I have no problem with you forking the code. If you do, I wish you the best of luck. And, do not feel like you cannot contact me and show me you weird and wonderful concoction. @@ -22,60 +22,60 @@ From my point-of-view, I am not in a rush to turn Console.Waterworks into a jack Before moving on, I would like to reiterate a point from above. You will not receive any ill-will from me if our goals do not align. It is okay to disagree. I am well aware one persons "done" is another person’s starting point. -## "I Don't want to Read this, I want to Ask a Quick Question" +## "I don't want to read this, I want to ask a quick question" -The easiest and faster way to contact me is via email. Which is craig@craigoates.net. I do not recommend filling an issue because of this. +The easiest and faster way to contact me is via email. Which is [craig@craigoates.net](craig@craigoates.net, "Craig's email address"). I do not recommend filling an issue because of this. ## "What Should I Know Before I Get Started?" -Before you jump in, I recommend you read The Complete Guide to Console.Waterworks. Console.Waterworks is not the most expansive or complex piece of code on the planet. But, it does have its own quirks and behaviours. That does not mean I have created a monster, though. I have tried to make it as modular and as easy to read as possible. But, it still has a reasonable amount of complexity to it. So, please read the guide. +Before you jump in, I recommend you read [The Complete Guide to Console.Waterworks](https://github.com/craigoates, "C.W. Complete Guide"). Console.Waterworks is not the most expansive or complex piece of code on the planet. But, it does have its own quirks and behaviours. I have tried to make it as modular and as easy to read as possible. But, it still has a reasonable amount of complexity to it. So, please read the guide. ## "How Can I Contribute?" -You can contribute to the project in several ways. The obvious two ways are filing issues and sending pull requests. You can, also, contribute by sending me an email. Although, the last one is not as open as the previous two. It is still an effective route to take if you want to discuss something at length. My email address is craig@craigoates.net. +You can contribute to the project in several ways. The obvious two ways are [filing issues](https://github.com/CraigOates/Console.Waterworks/issues/new, "C.W. Issues") and sending [pull requests](https://github.com/CraigOates/Console.Waterworks/compare, "C.W. Pull request"). You can, also, contribute by sending me an email. Although, the last one is not as open as the previous two. It is still an effective route to take if you want to discuss something at length. My email address is [craig@craigoates.net](craig@craigoates.net, "Craig's email address"). ### Reporting Bugs -I track bugs using GitHub Issues. If you find one, fill out the template provided and file an issue. +I track bugs using [GitHub Issues](https://github.com/CraigOates/Console.Waterworks/issues/new, "C.W. Issues"). If you find one, fill out the template provided and file an issue. -- Bug Report Template +- [Bug Report Template](https://github.com/CraigOates/Console.Waterworks/blob/develop/BUG_REPORT_TEMPLATE.md, "Bug Report Template") When you file a bug report, do not hold back with the details. The more information I have, the chance of me fixing it increases. ### Suggesting Enhancements -You might have read "The Creator's Expectations" above... If you have, you will know I hold a conservative attitude for adding features. With that said, I am not against adding new features -- stated above as well. If you believe your suggestion has some merit, please feel free to submit it. I am more than happy to discuss your plan. Please, do not feel offended if your suggestion does not get added to the project, though. That is not my intension. +You might have read [The Creator's Expectations](https://github.com/CraigOates/Console.Waterworks/blob/develop/CONTRIBUTING.md#the-creators-expectations-for-consolewaterworks, "Creator's Expections Section") above... If you have, you will know I hold a conservative attitude for adding features. With that said, I am not against adding new features -- stated above as well. If you believe your suggestion has some merit, please feel free to submit it. I am more than happy to discuss your plan. Please, do not feel offended if your suggestion does not get added to the project, though. That is not my intension. ### "How do I Submit an Enhancement Suggestion?" -You can submit an enhancement suggestion via GitHub Issues. Before you do, here is a list of things to consider when submitting an enhancement suggestion. +You can submit an enhancement suggestion via [GitHub Issues](https://github.com/CraigOates/Console.Waterworks/issues/new, "C.W. Issues"). Before you do, here is a list of things to consider when submitting an enhancement suggestion. - Use a clear and descriptive title for the issue to help identify the suggestion. -- Describe your enhancement in a brief summery. Aim to be as clear as possible. +- Describe your enhancement in a brief summary. Aim to be as clear as possible. - Highlight the area where this enhancement will improve Console.Waterworks. - Provide a summary of how you intend to add your suggestion. - If you have any step-by-step instructions, include them. - Include any code snippets you think will help explain your points better. You can provide either links to an external source or include them as markdown blocks. - Include screenshots and animated GIFs. They will help me understand your proposal better. It will, also, help explain where it will fit into Console.Waterworks. -- You can use Licecap to help you record GIFs. It is available on Windows and MacOS. If you are on Linux, you can use Silentcast or Byzanz. They are, also, GIF recording programs. +- You can use [Licecap](https://github.com/justinfrankel/licecap, "LiceCap GitHub Repository") to help you record GIFs. It is available on Windows and MacOS. If you are on Linux, you can use [Silentcast](https://github.com/colinkeenan/silentcast, "SilentCast GitHub Repository") or [Byzanz](http://github.com/gnome/byzanz, "Byzanz GitHub Repository"). They are, also, GIF recording programs. - Explain why this suggestion will be useful for most consumers of Console.Waterworks. I ask you to do this because it is one thing to work on Console.Waterworks and another to use it as a Nuget package. - List any other examples of your suggestion in a working context. Also, highlight the benefit it has brought to that codebase. -I have decided not to include a template here because writing proposals can be a messy and tricky affair. They can be the rally call to the great unknown or a meticulous path to paradise. Each one has its place in this world and I aim to keep it that way. With that said, try to keep your suggestion as clear and concise as possible. I ask this because -- to be frank -- if I do not understand your suggestion how can I agree to include it? +I have decided not to include a template here because writing proposals can be a messy and tricky affair. They can be the rally call to the great unknown or a meticulous path to paradise. Each approach has its place in this world and I aim to keep it that way. With that said, try to keep your suggestion as clear and concise as possible. I ask this because -- to be frank -- if I do not understand your suggestion how can I agree to include it? ### Pull Requests -Before submitting a pull request, I must stress the importance of talking to me first. I do not want you spending hours of your time writing code for Console.Waterworks to then face rejection. Your time is not my time and I would like to avoid wasting either of ours if I can help it. If there is something you would like to add to Console.Waterworks, you can do two things. The first is email me and talk about your plans. This is the quickest way for you to find out if your idea is worth pursuing. The second thing you can do is send an enhancement suggestion and hold the discussion there. This will result in a slower response but the conversation will be in the open. If you decide to file a suggestion, make sure you have read Suggesting Enhancements, above. Otherwise, my address is craig@craigoates.net +Before submitting a pull request, I must stress the importance of talking to me first. I do not want you spending hours of your time writing code for Console.Waterworks to then face rejection. Your time is not my time and I would like to avoid wasting either of ours if I can help it. If there is something you would like to add to Console.Waterworks, you can do two things. The first is [email me](craig@craigoates.net, "Craig's email address") and talk about your plans. This is the quickest way for you to find out if your idea is worth pursuing. The second thing you can do is send an [enhancement suggestion](https://github.com/CraigOates/Console.Waterworks/issues/new, "C.W. Issues") via GitHub Issues and hold the discussion there. This will result in a slower response but the conversation will be in the open. If you decide to file a suggestion, make sure you have read "Suggesting Enhancements", above. Now back to the pull requests... Here is a list of things to consider when submitting a pull request: -- Fill in the Pull Requests Template. +- Fill in the [Pull Requests Template](https://github.com/CraigOates/Console.Waterworks//blob/develop/PULL_REQUEST_TEMPLATE.md, "C.W. Pull request") - Do not include issue numbers in the pull request title. - Include screenshots and animated GIFs in your pull request whenever possible. - Follow the C# and Code Comments style guides. -- Describe how you intend to include the code into the projects documentation. +- Describe how you intend to add the code into the project's documentation. ## Style Guides @@ -93,33 +93,22 @@ As the title of this section implies, the following pertains to a collection of ### C# (C-Sharp) -Aim to adhere to the C# Standard Style. If you are working in Visual Studio, the automatic formatting should suffice. Here are a few examples. +Aim to adhere to the standard C# coding conventions. If you are working in Visual Studio, the automatic formatting should suffice. -- Brackets -- private class level variable names -- private method level variable names -- Class names -- Interface derived class names -- Casing -- Code Comments +I have tried to reduce the inclusion of comments to public facing and "messy" code. This is due -- for the most part -- to intelliSense. It provides the user of Console.Waterworks with help when wiring it up to their console program. With that said, what makes sense to me does not mean it does for you. So, if you feel like something needs further explanation, please add a comment. I would prefer it is comments aimed to explain the "why" and not the "how" or "what". But, this preference is a starting point and not an absolute. If you add a comment, please use XML-Comments for public code and standard comments for private code. I am not fussed if you use one multi-line comment or several inline ones. -I have tried to reduce the inclusion of comments to public facing "messy" code. This is due -- for the most part -- to intelliSense. It provides the user of Console.Waterworks with help when wiring it up to their console program. With that said, what makes sense to mean does not mean it does for you. So, if you feel like something needs further explanation, please add a comment. I would prefer it is comments aimed to explain the "why" and not the "how" or "what". But, this preference is a starting point and not an absolute. If you add a comment, please use XML-Comments for public code and standard comments for private code. I am not fussed when it comes to one multi-line comment or several inline ones. - -Here are a few examples: - -- XML-COMMENTS -- Inline comments -- Multi-line comments +- [C# Coding Conventions](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/coding-conventions, "C# Coding Conventions") +- [C# Documentation Comments](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/language-specification/documentation-comments, "C# Comment Doc's") ## And even more Notes -If you would like to contribute to the project, thank you. Before you do, though, please make sure no one has already beaten you to saying or adding it first. I am yet to come across someone whom likes dealing with repeated issues, points or mistakes and I doubt I ever will. I appreciate all efforts by those checking to see if what they are saying is something new. On top of that, rejecting fifty individual issues is better than rejecting fifty of the same one. Well... that is my position of that anyway. +If you would like to contribute to the project, thank you. Before you do, though, please make sure no one has already provided what you are offering. I am yet to come across someone with a liking for processing repeated issues, points or mistakes. And, I doubt I ever will, so please check. I appreciate all efforts by those checking to see if what they are saying is something new. On top of that, rejecting fifty individual issues is better than rejecting fifty of the same one. Well... that is my position of that anyway. -Do not feel put-off if I am slow to respond. I will read what you have to say but I am not at my desk all the time. On top of that, I encourage you to refrain from instant replies if you can help it. This allows me to consider what you have said without feeling pressured. I do not want to waste your time by retracting a hasty and ill-thought response. +Do not feel put-off if I am slow to respond. I will read what you have to say but I am not at my desk all the time. On top of that, I encourage you to refrain from instant replies if you can help it. This allows me to consider what you have said without feeling pressured. I do not want to waste your time by retracting a hasty and ill-thought-through response. And with that... -Do not feel like you need to reply back as fast as possible. If you feel the need to ponder something, do so. I am under the impression a good answer is better than a quick one. If you still feel bad for not replying as fast as possible, I have a piece of advice. Let me know you have received the communication (email, issue comment Etc.) and state you are thinking about it -- job's a goodun. +Do not feel like you need to reply back as fast as possible. If you feel the need to ponder something, do so. I am under the impression a good answer is better than a quick one. If you still feel bad for not replying as fast as possible, I have a piece of advice: Let me know you have received the communication (email, issue comment Etc.) and state you are thinking about it -- job's a goodun. Last but not least... diff --git a/Console.Waterworks/CW_Console/ConsoleCommands.cs b/Console.Waterworks/CW_Console/ConsoleCommands.cs index 4e3c07e..1cf61f9 100644 --- a/Console.Waterworks/CW_Console/ConsoleCommands.cs +++ b/Console.Waterworks/CW_Console/ConsoleCommands.cs @@ -21,7 +21,7 @@ namespace CW_Console } [ListCommand()] - [Description("Outputs a message indicating this programis running okay.")] + [Description("Outputs a message indicating this program is running okay.")] [Parameters("None")] [Usage("CW_Console> Test")] public static string Test() => "Test complete."; diff --git a/Documentation/README_Assets/README_Invalid_Input.png b/Documentation/README_Assets/README_Invalid_Input.png new file mode 100644 index 0000000000000000000000000000000000000000..d853eaa89305686760d01b92ed60deb379afb1e2 GIT binary patch literal 56226 zcmeFZc{r49_&+?Nq%2R1O14U+NQCTLc|r(fU$T`gTN?Xdl;U|*RI)Fl?CX#%%NUZ# zGK0Zj%nXUKPYk9pX6C&|p5OcX9q&KydmQhd-;SeV=Dx4%ysqn9KIi8=@B3df6Meoz zrw@TZAimoMf8PUvxCcNWF8sj*z$Yh7`qhB{IKcPxZ-OdOA`8GTTpl;>+yH^96A$mW z><515d2C<{27&lH*nc^?{EHugKse>wf8VeObzH`q`aGP?mR()6jSjpXZC}MxagZ8I z;GGit^z;ty^uInjV~0+AjZHazuysM>@8AFKnzws`Y&*>mteQh44%`(&3;}3R<7T@2uBxRM7-a3w`j@08S)qh0%CM$Ct~SG=gWE-m6+xba=kyk$+Eo84h#lY^rp(v z9R~4OciiVldhlAGlg!nt6RdsgiQ0r-Z(gL2j#|+x8VFLOCiRVtmrs?B{rKV9Y@=a? zqPB7hFzo1duc-X12Czu9`!3$ungcjMjiRx`c7cITyN)DcHBb7)*jV>W_i=5w|1mSU^5>2h)T%_VX;0j?R4)kE%zUOI zaU!tYA$n+;KaRw1&1L$ZFp_Kzn9+kv@vG>?I$Tw_4yw73ohYBBy?dRU?Y=;h3ZHpN zk>@jR$6o}>KaDw>gS)!>UGC|9fzk2Ba&vOis=FUp7)7H>WUgE}Zp27tsHI(?)9EXC zJl=KXA%#Mz=+8#d=3w8G>k5p&@>-d2DaE9|scAwD%G_ym6}-fI z2z@Mtyu4iNM{JF(q}1Vq0o?#YAP_uS5OYCPN?x2PH>B$2>swJ*T|MXvY(Ad<mL-jexf|~vA41DBqAWnz5nM%NjvJFx}+NvB4*;#>G4wN zuB-UY{a)J%M`0btRY_Sf>xY7|3?gxR;4Mt`FMQaGR z+Efinn!1)PYx0Qk?EBp&KuN0uEwoH&K7wV&jVP_!;m6FkgWU3`+h==IO((UkI<|!R zMMg3l^knCKFr77j#GgH?7bMoBC}s6=J0RClE`71 zA5U=aeQLPY>KhiOnmB-dyHbcMYB5PXaV^PKP_K>NejoQwCyl)V}i`R9INJ@ayiF z(L8_UavF~zAk_E^?zV-^pTj8b)xn=$yx0%^!O6a&?fJn0j@*5K@c{Svx2)+^bM4;v z3TGod5gZ&mVPs^~Y3C%#6cbwf>{RD2Md9c7&Wvw;eiWhVMw**za!P7!Y&PXRi-cB( zmUpnIx7XD-GiQ{*xRh+=7HW+jz9}d_J}4j{pcocpMuIfM?Zvy8eRmOhakJz;V%jM9 zH(9tg(ye>O8(Yc8fWq=Al!J7Z6w)os!|+N?Sdq z+XSKdQG+zUPp?R_psi8IVMV7lZ2!5T4H+Q*71z)l1Bb-+wF3509X!0a_-LsP>nJ_S zG-7UHT2})eJEahzk&%ezh^(ZjIF(iEe8YXwo$Z$3@tknD6M^hgQ#9`JHGtgdrA^U{ zArL#Dtm(+8abyXVl`lG(ItMXrjuh|?3k!4JAI>D8$jWbtB$c?tb`ORKFP*7ZPmbv- z@_FD@g!fAX4{g0!x$NtJ`#OzYosRrpuWCV52fF>jitTH>*!nQs#l6K&W_tQ@#-u(;C}qu*QGIa6~@ zQ%tWu?*>T-kwWwZgDJ+iTTEn25n~JPggJs|fjO}MIIu&{1!JC-#mG3R`$Uff{3LDIF~7NJn|21< z8GiR|f}b-xJK*&2hzG_mwPt&HB!RBE%~!!uv2Sl- z7;hS+=Rl4Zg0Ycna<;3^rGe~noX&WlQOKV^uuS~kJghCN-4

^SZbG;(__1 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 H`@jAdD>UB^ literal 0 HcmV?d00001 diff --git a/Documentation/README_Assets/README_Method_Mapping.gif b/Documentation/README_Assets/README_Method_Mapping.gif new file mode 100644 index 0000000000000000000000000000000000000000..ac5570929e1e88c615c25a2d3934133eeef954cc GIT binary patch literal 23836 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 literal 0 HcmV?d00001 diff --git a/Documentation/README_Assets/README_Valid_Input.png b/Documentation/README_Assets/README_Valid_Input.png new file mode 100644 index 0000000000000000000000000000000000000000..d2bdfbdfa44f27af9703f2d3da121127ce3207df GIT binary patch literal 22776 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 literal 0 HcmV?d00001 diff --git a/README.md b/README.md index 4acb53a..62354a7 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,36 @@ # Console.Waterworks - ReadMe (This is incomplete) -Console.Waterworks is a Nuget package. It aims to help you write extendable and command-based console programs in C# and .Net. +Console.Waterworks is a Nuget package. It aim is to help you write extendable and command-based console programs in C# and .Net. One of the main struggles with writing software is the need to write "plumbing code". It is the code which does not solve the main problem but it is necessary for us to reach a solution. This is why we all feel frustrated when we need to write it. It feels like we are going the long way round to that dream holiday in the sun. This is why I created Console.Waterworks. I believe we should face frustration when it finds us and only then. Why go looking for it? Amongst other things, Console.Waterworks has this one very handy trick. It allows you to write methods which become a run-time command -- which is quite the time saver. When you use Console.Waterworks, you, also, do not need to parse end-user input. The reason why is because Console.Waterworks does it for you. This means, when people run your program, they type the method name in and your code begins excuting. On top of that, Console.Waterworks handles bad input and method parameters, as well. -Do not panic if none of what I just said made no sense. I threw a lot of information at you in a short span of time. It is okay and not unexpected. Because of this, I have prepared a gif showing Console.Waterworks in action. Please feel free to check it out. It should help explain what Console.Waterwork is and how it works. +Do not panic if none of what I just said made no sense. I threw a lot of information at you in a short span of time. It is okay and not unexpected. Because of this, I have prepared several images showing Console.Waterworks in action. Please feel free to check it out. It should help explain what Console.Waterwork is and how it works. -**Insert gif here** +![Example 1](Documentation/README_Assets/README_Valid_Input.png "Valid input diagram") + +![Example 2](Documentation/README_Assets/README_Method_Mapping.gif "Method mapping example -- valid") + +![Example 3](Documentation/README_Assets/README_Invalid_Input.png "Invalid input diagram") + +![Example 4](Documentation/README_Assets/README_Method_Mapping_Invalid.gif "Method mapping example -- invalid") + +## Disclaimer + +Console.Waterworks is based on the [ConsoleApplicationBase](https://github.com/TypecastException/ConsoleApplicationBase, "ConsoleApplicationBase GitHub Repository") repository by [TypecastException](https://github.com/TypecastException, "TypecastException's GitHub Profile"). ## Pre-Requisites To use Console.Waterworks, I recommend you meet the following pre-requisites: -- You have experience with C#. -- You can create a .Net console program in Visual Studio 2017 or Visual Studio Code. -- You have experience with Nuget. -- You have Microsoft .Net Framework 4.7 or higher. +- You have experience with [C#](https://docs.microsoft.com/en-us/dotnet/csharp/, "C# Documentation"). +- You can create a [.Net console program](http://www.com, "Console program tutorial") in [Visual Studio 2017](https://www.visualstudio.com/vs/, "Visual Studio 2017 Info.") or [Visual Studio Code](https://code.visualstudio.com/, "Visual Studio Code Info."). +- You have experience with [Nuget](https://www.nuget.org/, "Nuget's website"). +- You have Microsoft [.Net Framework 4.7](https://docs.microsoft.com/en-us/dotnet/framework/install/guide-for-developers, ".Net Framework download") or higher. -## Quick Start +## Quick Start - Wiring Console.Waterworks in to your Console Program -Before continuing... I am skipping the part about creating a .Net console program. This is because I assume you know to do that. I am, also, assuming you are using Visual Studio 2017 and C# (and not VB or F#). +Before continuing... I am skipping the part about creating a .Net console program. This is because I assume you know how to do that. I am, also, assuming you are using Visual Studio 2017 and C# (not VB or F#). 1 Add Console.Waterworks to your project via Nuget. You can do this using Visual Studio's (2017) Package Manager GUI. Or, you can use the Package Manager Console. Here is the command for the PM Console, @@ -28,34 +38,34 @@ Before continuing... I am skipping the part about creating a .Net console progra Install-Package Console.Waterworks -Version 0.1.0-alpha1 ``` -2 Create a class called `ConsoleCommands`. It can go anywhere as long as it is in the same project as the console program project. +2 Create a class called `ConsoleCommands`. It can go anywhere as long as it is in the same project as the console program. 3 Make a note of the `ConsoleCommands` namespace. -4 Head to the `Main` method is `Program.cs` and add the following lines of code, +4 Head to the `Main` method in `Program.cs` and add the following lines of code, ```c# public static void Main(string[] args) { - CW_Liaison bob = new CW_Liaison(); - bob.Run("CW_Console", true); + CW_Liaison liaison = new CW_Liaison(); + liaison.Run("CW_Console", true); } ``` -5 Head back to `ConsoleCommands` and make it public. +5 Head back to `ConsoleCommands` and make it public and static. -6 Stay in `ConsoleCommands` and write the following line, +6 Stay in `ConsoleCommands` and write the following method, ```c# -public static string Test() +public string Test() { return "Congratulations! It works."; } ``` -7 Run the program and type *"Test"* into the console. +7 Run the program and type "Test" into the console. -8 If all has gone well, you should see the *“Congratulations! It works."* message. +8 If all has gone well, you should see the “Congratulations! It works." message. 9 Add more methods to you console program. @@ -70,13 +80,13 @@ I have created two guides for offline usage: - The Quick Guide to Console.Waterworks - The Complete Guide to Console.Waterworks -Both of these guides are printer friendly. And, they are best consumed on your favourite reading chair. If you are away from the world-wide web, these guides are, also, for you. +Both of these guides are printer friendly. And, they are best consumed on your favourite reading chair. ### Online For those sitting at their computer and connected to the world-wide web, there is a Wiki: -- GitHub Wiki +- [GitHub Wiki](https://github.com/CraigOates/Console.Waterworks/wiki, "Console.Waterworks Wiki") This guide aims to be a concise as possible. It assumes you are sitting at your desk and wanting the quick answer -- not the full answer. @@ -84,17 +94,18 @@ This guide aims to be a concise as possible. It assumes you are sitting at your Please visit the Code of Conduct page for Console.Waterworks at, -- Code of Conduct page +- [Code of Conduct page](https://github.com/CraigOates/Console.Waterworks/blob/master/CODE_OF_CONDUCT.md, "Code of Conduct page") ## Contributing to the Console.Waterworks Repository Please visit the Contributing page for Console.Waterworks at, -- Contributing page +- [Contributing page](https://github.com/CraigOates/Console.Waterworks/blob/master/CONTRIBUTING.md, "Contributing page") ## About the Creator Hi, my name is Craig and I'm the creator of Console.Waterworks. Thanks for checking it out. -- Email: craig@craigoates.net -- Web: http://www.craigoates.net \ No newline at end of file +- Email: [craig@craigoates.net](craig@craigoates.net, "Craig's email address") +- Web: [http://www.craigoates.net](http://www.craigoates.net, "Craig's main site") +- Project's Site: [http://craigsappshed.azurewebsites.net/Waterworks](http://craigsappshed.azurewebsites.net/Waterworks, "Project's site") \ No newline at end of file