Adding a site to the iOS Dev Directory
Is there something missing from this directory? Here’s everything you need to know to get it added.
Guidelines for Inclusion
Ideally, only sites relevant to iOS development or design will be added to this directory. However, if your site is not purely about iOS Development or design and includes other topics please try and use categories (if your blog software supports them) to filter it down before submission.
For example if you post mainly about Swift development, occasionally about iOS design and sometimes about other topics, the best solution would be to do this:
- Add a link to your site’s development related posts to the development category.
- Add a link to your site’s design related posts to the design category.
- Leave out the other categories from your site.
If that is not possible because your blog software doesn’t support categories, that’s still OK! I’d like this site to err on the side of inclusion and so if your blog is partially about something related to iOS development and partially about something else, submit it anyway!
If you think there’s a category missing or want to suggest a bigger change to the site, open an issue.
Multiple Language Support
This site now supports multiple languages, and categories within those languages. If your blog or site is written in a language that has not yet been added, please feel free to add that language in the JSON and the site will automatically be expanded to include it.
How to Contribute
These simple instructions should be everything you need to get a new site included in the directory:
- Fork this repository on GitHub.
- Edit blogs.json and add your site. See below for the details of the JSON format.
- Submit a pull request.
Once the pull request is accepted and merged, this site will be re-generated and your link will magically appear! Thank you for wanting to contribute.
Adding your site
Your site should be added as a JSON hash in the correct category. The following keys are valid:
title– The title of the blog/site. If it is just a personal blog, use the format "John Appleseed's Blog". This field is required.
author– A free text string containing the author(s) names. Try to keep this less than 30 characters. This field is required.
site_url– A valid URL to the web version of the blog/site. This field is required.
feed_url– A valid URL to the RSS/ATOM feed for the blog/site. This field is required.
twitter_url– A valid URL to the Twitter account for the blog/site. This field is optional.
mastodon_url– A valid URL to the Mastodon account for the blog/site. This field is optional.
microblog_url– A valid URL to the Micro.blog account for the blog/site. This field is optional.
weibo_url– A valid URL to the Weibo account for the blog/site. This field is optional.