Blog Post Guide

Welcome to NYC Data Science Academy Blog! We're excited about your participation!

This blog site is a platform where our students share their data science projects. If this is your first time to post a blog, please take some time to review this page - it should answer any questions you have about the profile set-up, blog contents, and formats.

 


 

*1. Set up your blog profile

You could modify your blog profile in "Dashboard". Make sure you have updated your biographical info and uploaded your profile picture.

The nickname field is used as the unique identifier for your blog author link, e.g. http://blog.nycdatascience.com/author/taiertu/
Screen Shot 2016-07-25 at 11.16.16 AMScreen Shot 2016-07-25 at 11.16.07 AM

*2. Embed an introduction paragraph in the front of your blog

Please include the following information in this introduction paragraph:

1) Contributed by XXX (#your name).

2) XXX took YYY (#course name)  taking place between MM-MM, YY (#period; e.g. Mar-Apr, 2014).

3) The post was based on his/her … …(#reason to submit such a project; e.g. final project submission).

Example:

Contributed by Ruonan Ding. She is currently in the NYC Data Science Academy 12 week full time Data Science Bootcamp program taking place between April 11th to July 1st, 2016. This post is based on her second class project - Shiny (due on the 4th week of the program).

 

3. Add slides/videos

If you have slides and/or videos (including desktop record and camera record) about your presentation, you could embed them in your blog.

For slides, please upload it to slideshare and embed it. Change width to 700, height to 580 in the text mode.

For presentation videos, please first ask Vivian to help upload them in YouTube. You will have a URL for your recording which allows you to embed in your blog. Change the width to 700 and height to 520 in the text mode.

*4. Project structure

1) Background and goal(s).

2) How did you conduct this project? Please explain step by step and include the codes.

3) Conclusion and visualizations. Please show the diagrams, charts or any other image to present your great job!

*5. Add code to your post

Adding code to blog post is easy:

1) First, you need to create a Gist account or login in using your GitHub account at https://gist.github.com/
2) On Gist, click New gist, paste your code to the text editor, name your file, and click Create gist.
Screen Shot 2016-07-25 at 12.17.20 PM
3) Copy the gist’s URL from your web browser’s address bar while viewing the gist.

Screen Shot 2016-07-25 at 12.18.41 PM

 

4) Back to blog site, paste it on a line by itself in your post/page editor.

Screen Shot 2016-07-25 at 12.19.53 PM

5) Switch back to the Visual mode, your code section will look like this!

Screen Shot 2016-07-25 at 12.20.03 PM

 

*6. Don't forget to set a featured image and select a category

The featured image will show on the top of your post. Setting a proper category will help your project gain more exposure.

Screen Shot 2016-07-25 at 11.58.11 AM

7. Reference. If you have the reference or other useful materials, you could add their links at the end of this blog.

8. Others:

1) Click "Add Media" to upload and insert images
2) More about Gist: https://en.support.wordpress.com/gist/
3) Insert interactive Plotly graphs into your WordPress blog: https://wordpress.org/plugins/wp-plotly/
4) Embed Tableau Workbook into your WordPress blog: https://www.alightanalytics.com/alight-insights/embedding-tableau-workbooks-wordpress-blogs/
5) Currently WordPress is not compatible with GoogleVis graphs or LeafLet R. Please add screenshots of your graphs instead.
6) Not recommend pasting the entire R markdown file to the Text editor in WordPress; It will crash your browser unless the markdown file is small (i.e. less than 1 MB).
7) Co-authors on single post is available - admins will help assign authors after the post is published /or ready to publish.
Check out David Comfort's post for a reference.

* means required

Vivian Zhang
Vivian Zhang
Vivian is a data scientist who has been devoted to the analytics industry and the development and use of data technologies for several years. She obtained expertise in data analysis and data management as a Senior Analyst and Biostatistician at Memorial Sloan-Kettering Cancer Center and Scientific Programmer at Brown University. She is the co-founder of SupStat, founder of NYC Data Science Academy and the NYC Open Data meetup. She earned her M.S. in Computer Science and Statistics and B.S. in Computer Science. Vivian is a programmer and all-around dataholic, and considers herself a visualization evangelist.

Leave a Reply

Your email address will not be published. Required fields are marked *