pluralsight / guides

Article back-end for hack.guides() website

hack.guides()

Welcome to the hack.guides() content repository. This repository contains published and unpublished versions of awesome technical guides written by our community. You can browse all the guides right here or head over to our companion site for a more focused reading experience.

What is hack.guides()?

A community, movement, and website of full of developers with the ambitious goal of educating ourselves and the world.

Join the movement

You have unique experience, and we want to help you share it. We have several ways for you to contribute to our mission of educating the world.

1. Write your own guide.
2. Find a guide to review and help out the author by editing their work.
3. Fork our Github-powered CMS and help us improve the experience of creating and consuming great technical guides.
4. Fork this repository using the fork button above and send us a Pull Request with your edits.
5. Join our slack community
6. Tell your friends!

What's in it for you?

We've all learned by reading great content on the web. Now is your chance to give back. Studies show the best way to learn is by teaching. In fact, writing is a great way to teach and learn at the same time.

Sharing your knowledge is also a great way to promote your personal brand and build your reputation in the development community.

Looking for a new job? Sharing great content with potential employers is the perfect way to prove yourself before even walking into the interview room.

Repository organization

We are working hard to create a great reading experience on our website. We've also taken care to neatly organize our content in this repository. If you're a fan of git, Github, and the CLI you're in the right place. From here you can clone or fork this repository and read all the guides in whatever environment you choose.

Here's an abbreviated look at how this repository is structured:

|---- faq.md
|---- published.md
|---+ published
|----   + c-c++
|----   + ruby-ruby-on-rails
|----   + python
|----   +   + guide-1
|----   +       article.md
|----   +       details.json
|
|---- in-review.md
|---+ in-review
|----   + c-c++
|----   +   + guide-2
|----   +       article.md
|----   +       details.json
|----   + ruby-ruby-on-rails
|----   + python
|
|---- draft.md
|---+ draft
|----   + c-c++
|----   + ruby-ruby-on-rails
|----   +   + guide-3
|----   +       article.md
|----   +       details.json
|----   + python

There are main 3 directories, published, in-review, and draft. Each of these directories corresponds to how complete a guide is. Guides in the 'in-review' folder are currently undergoing editing from authors and our community editors. Guides in the 'draft' folder are in-progress and not ready for external reviewers yet.

Reading

You can browse the content right here. Start by picking whether you want to read published, in-review, or draft guides. Then pick the corresponding file, published.md, in_review.md, or draft.md. These files will give you an overview of all the guides in that stage.

You can also browse the directories for each publish stage. Each publish stage folder has another list of folders organized by topic or stack. So, you can easily skip to the categories that are most interesting to you.

Finally, inside each category is another list of directories, 1 for each guide. Each guide is organized in a single directory named after the title of the guide. In each directory, you'll find a file named article.md. Clicking on that file lets you read the content directly on github.com.

Editing

Got an idea for improving the article? Click the fork button in the top-right corner of the article, edit it directly on github.com, and send us a Pull Request with your contribution. No software installation necessary!

Want to easily browse the guides?

1. Click on the published.md file to see our published guides.
   • Here you can find links to our top guides as well as links to read more from your favorite contributors.
2. Click on the draft.md file to search through drafts of potential guides.
3. Click on the in_review.md file to search through completed drafts that are undergoing final evalutation and review.

Creating a new guide the hacker way

We're hackers too and there's nothing like creating content from your own environment. Feel free to clone this repository, create your own directory with article.md and details.json files inside the draft or in-review folders, and send us a Pull Request.

We're constantly working on improving this experience. Soon we'll have an easy-to-use script to automatically setup the guide for you. All you worry about is writing great content.

Keep checking back for that, but until then copy an existing details.json file, fill it in with your information, and send us a Pull Request. We're happy to walk you through it!

guides's Issues

Initial creation of an article does not update your author page

After publishing an article in the web UI, my user page does not list it. My user page does list the article after I submit an edit.

core no longer exists

It looks like the core directory has changed in more recent versions of ansible can you update?

Remove this Ionic 2 tutorial

I made this tutorial but with the recent Ionic 2.0-RC.0 all this database versioning goes to hell, now it doesn't work any more, so i suggest we delete the tutorial since it doesn't even work any more.

https://github.com/pluralsight/guides/blob/master/published/software-engineering-best-practices/ionic-2-database-management-and-versioning/article.md

Grammatical error in `Everything you need to know about JSON`.

In the article Everything you need to know about JSON, in the first paragraph of the section named The Rules, there's the following sentence:

The values contained by objects and arrays, must also be JSON serialisable.

The comma should not be there.

how to host node js alexa project on local server(public IP)

I am trying to host this node JS code on local server , but not getting success.

could you please help me on the same

Punctuation should be outside of grave accents when using Markdown

I just revisited one of the docs I wrote, and found that it had been edited, and that punctuation had been added to inline code samples. I understand that most people follow the convention of placing punctuation inside quotes, even though the punctuation is not part of the quote. For example:

He said "hello," but no one heard.

However, adding punctuation to code samples is incorrect and corrupts the code in the sample. For example, this would be wrong:

There is a helper named `foo,` though not in early versions.

The correct markup would be...

There is a helper named `foo`, though not in early versions.

Code samples are only marked up with grave accents; there are no actual quotes in the rendered document. Adding punctuation to code samples also introduces syntax errors in that code.

I've fixed this issue in my tutorials, but it's presumably not isolated to just those two.

Missing information re compiling typescript in the angular2-rails guide

The react-vs-angular-2-integration-with-rails guide is missing information on how to compile the typescript files into javascript.

After explaining how and where to add the typescript files the guide says to run rails server and visit localhost:3000, unfortunately, this doesn't work because the browser is looking for boot.js and there is no information on what command would need to be run to get that. I double checked against the completed repo linked in the guide and all of my files are identical, except the completed repo already includes the .js files (with no indication of how they got there).

It would be much clearer if the guide could be updated to include that extra step. Thanks!

override post and get

Hi, thanks for the tutorial, very clear and useful. I want to override the post and get methods of the exposed servlet to parse the request object (namely to check and validate a jwt token). How would you that? Thanks for any help you might provide.

using-a-spreadsheet-to-power-charts-in-angularjs-apps doesn't seem to work

When I download your codepen from the using-a-spreadsheet-to-power-charts-in-angularjs-apps tutorial it doesn't seem to work:

https://github.com/pluralsight/guides/blob/master/published/front-end-javascript/using-a-spreadsheet-to-power-charts-in-angularjs-apps/article.md

@rohitb4

Python Docstring highlighting highly unreliable

Hey, thought I'd report this, but if you write a python codeblock like this

def lowerfirst(string):
    """
    This function takes an input string, and if the string is equal to the word "I", it will simply return that word.
    This function takes an input string, and if the string is equal to the word "I", it will simply return that word
    However, if the string is not equal to "I", it will attempt to lower the first letter by assigning it to a temporary
    variable, tmp, and will then append all following letters to it, returning this value once finished

    WARNING: This will break if the word given is only 1 letter long and not equal to I
    """



    if string == "I":
        return string
    else:
        tmp = string[0].lower()
        for i in range(1,len(str)):
            tmp += i
        return tmp

The docstring will highlight as code, e.g.

This can be fixed by doing this

def lowerfirst(string):
    """
    This function takes an input string, and if the string is equal to the word "I", it will simply return that word.
    This function takes an input string, and if the string is equal to the word "I", it will simply return that word
    However, if the string is not equal to "I", it will attempt to lower the first letter by assigning it to a temporary
    variable, tmp, and will then append all following letters to it, returning this value once finished

    WARNING: This will break if the word given is only 1 letter long and not equal to I
    """

   """
   FIX
   """


    if string == "I":
        return string
    else:
        tmp = string[0].lower()
        for i in range(1,len(str)):
            tmp += i
        return tmp

I reckon this would benefit from being fixed