Skip to content

Latest commit

 

History

History
83 lines (54 loc) · 6.89 KB

File metadata and controls

83 lines (54 loc) · 6.89 KB

Frequently Asked Questions

How do I suggest a topic to write about?

We encourage all new contributors to go over our new contributor folder which has a list of resources to prepare to submit a new topic and article idea. We also suggest to review the most recently published articles to avoid topic overlap (and to get a good sense on article style tonality, and quality that we are accepting) submit a topic using this issue form.

How do I submit a EngEd feature suggestion?

To suggest a (potential) EngEd feature suggestion fill this form out.

How do I submit my 1st article?

Visit our step-by-step guide on how to upload your 1st EngEd article to the GitHub repo.

How do I submit a Pull Request?

Here is a link to a short video further explaining what a pull request is.

How do GitHub forks work?

Here is a link to a short video further explaining what a pull request is and how to fork a Github repository.

How do I add my author page

Include a short Author Biography (index.md file) and Headshot image (avatar file). Include these files in the authors folder within the GitHub repo via your forked repo similar to the article files. We want to credit you for your hard work.

I have a merge conflict - how do I resolve it?

Use this every time before contributing a new article to keep it up to date git fetch section

git pull --rebase section master

git push origin

This should help prevent any merge conflicts.

For more details on how to submit a PR check out our contribution guidelines here.

Can I include a video into my articles?

Yes, please refer to our upload instructions for a step-by-step guide on how to include YT videos into your articles.

Is there a word limit on articles?

The only requirement is that the article has to be at least 750 words, there is no upper cap limit as we want to ensure we are providing value to the EngEd community and the developer audience at large.

Articles should be a minimum of 750 words.

How does the revision process work?

Articles with (little to no extra revisions needed) will recieve priorty in the queue.

For the full details on our review, approval, & payment processes check out the provided link.

What is the difference between a tutorial and an article?

A tutorial is a walk-through implementation on a topic. For example: How to set up Ubuntu on Linux. Steps laid out, with screenshots, and accompanying snippets. An article is a piece describing, explaining, or exploring a topic (with out any steps on HOW TO implement). For example - The Difference between Java and C++.

What counts as a round of revision?

Any extra (major) steps that take a reviewer away from the actual revision process (revising, editing, and proofreading) and causes a shift towards content creation. Any (major) incorrect code snippets (all code should be tested - contributors should take advantage of free tools such as repl.it). Instances when the content is too difficult to understand. PRs that may lack sufficient unique* value - (any and all comments made by reviewers to draw out more value from the article are great and encouraged but should be limited) *by unique we mean content that can NOT simply be found by looking up the official documentation.

Use your EngEd community as a resource - get to know each other and ask for a revision from a fellow contributor before submitting a final draft.

Please do not hesitate to reach out at any time - we’re always happy to help.

How does one apply to be a Peer Reviewer?

For the Content Stewards (Peer Review Program) we typically look for authors who have contributed a few articles (so that they are familiar with the article submission process) and can guide new contributors along the way.

Most importantly we look for authors who have demonstrated great technical acumen, overall attention to detail (grammar, formatting, etc.), and community engagement.

The position is a compensated position - 50 USD per successful article review.

Are the positions voluntary or are Peer Reviewers compensated?

We always encourage friendly reviews among the community to help each other out before article submission. Verified Peer Reviewers are paid $50.00 USD per successful article revision.

Are articles published compensated?

No. The value that the EngEd program is providing to students is that of career building, skill enrichments, community building, and portfolio that can be referenced and leveraged upon entering the workforce.

Does Section provide revision services?

We will look over the all articles that come in to ensure they are publish worthy - but our peer reviewer team is only looking to improve the content by making suggestions. For revisions services we recommend using a few of the services we have vetted - both economical and professional.

Can we re-post our work elsewhere?

We ask that if you would like to repost your Section work elsewhere, that new work reference the original Section (EngEd) article. Adding a rel=canonical tag is the preferred path forward. This does not mean that published work on EngEd can be previosly published elsewhere - we still ask for original and unique work.

How do I respond to comments on my article?

After you have published your article with us - be sure to check on your content periodically to respond to any comments or questions that the audience may post. Please sign up with HyvorTalk to reply to any comments or questions left on your articles.