Skip to content

Latest commit

 

History

History
50 lines (29 loc) · 4.53 KB

CONTRIBUTING.md

File metadata and controls

50 lines (29 loc) · 4.53 KB

We love that you're interested in contributing to iOS Goodies! 🦄🦄🦄

To make the process as painless as possible, we have just a couple of guidelines that should make life easier and less frustrating for everyone. ♥️

Before we start, please read our Code of Conduct (we take it very seriously 😁).

Contributing

If you would like to contribute with a link to the current week's issue send us a Pull Request. After being accepted, the article will stay in the repo, still it does not guarantee that will be presented on the website, or the newsletter. There are two main reasons for a contribution to be rejected:

  • Each section has a limit of 5 articles (in special occasions, we can bend this rule and change the upper limit).
  • The article didn't pass our curation. This can be for multiple reasons: poorly written, not relevant to the community in general, not up to our standards, etc. Of course this is very subjective and if you think we are being unfair, do let us know.

You can include more than one article in a pull request.

Requirements

Shouldn't be more than 2 weeks old (although exceptions can be made: e.g. Tools/Libraries). If it's an old article, but a good one, please let us know why you think so.

General Workflow

Each week we launch the goodies on Thursday and create a new markdown file that will have the issues for the next week. Marius is responsible for launching the Goodies (Website + newsletter).

Your approved contribution didn't make the newsletter

As a general rule, please do not submit your link again if it was not selected to be part of the newsletter. We reserve the right to include the link again under special circumstances (i.e. the previous newsletter had a large number of contributions). If you feel your contribution deserves a second look, please open an issue.

Categories

  • Articles - Generally speaking these are technical articles. They should expose the reader to code, but it's not mandatory.
  • Tools- Links to tools or libraries related to iOS development. Could range from tools like Sketch (because in one way or another is used while developing iOS apps) to fastlane, passing by Trending Github repos (Objective-c, Swift, Objective-c++, etc).
  • Business/Career - These articles should help the typical developer to understand how business is conducted. This could be related to the App store ecosystem, or how-to run your business as an indie dev, App marketing, etc. It can also be related about your experience while working at some company, what you liked, and what you didn't like. In addition to those, this category can also contain articles about productivity, growing as a developer, teamwork, workplace happiness and career development.
  • UI/UX - Should mainly focus on UI and UX but in an Mobile context, user flows, maybe describing a new pattern. It could be acceptable to use an article that, although uses Android as the example, is applicable in iOS. Some articles for Web, can also be interesting to an iOS dev.
  • Videos - Self explanatory
  • Credits - Comma separated list of contributors to the current issue. If you make a pull request, add yourself here like this: [your GitHub username](your GitHub link)

In case the article is really good, and doesn't fit in any of the above sections, we will open a new section just for it. If you are unsure where to put an article, check the website for some examples, or just open an issue.

Link Format

We use markdown for each issue, and each link should respect this rules:

  • Should follow this format: [Title of the Article](link), by [Author's Twitter username](link-for-twitter)
    • If the author doesn't have a twitter account then use his name instead of the Twitter username, without a link
    • For the Tools/Controls sections, where we showcase repos on GitHub, you can also include the short description of the repo. i.e.: [SwiftLint](https://github.com/realm/swiftlint) - A tool to enforce Swift style and conventions, by [@realm](https://twitter.com/realm)

Previous Issues

If you would like to fix a typo/link for the current or passed week send us a Pull Request.