App-Open-Source-per-iPhone-.../.github/CONTRIBUTING.md

2.8 KiB

To contribute toopen-source-ios-apps, update the contents.json file (this will generate the README).

New category

Please open an issue and contact @dkhamsing, @kvnbautista or @scribblemaniac.

Delete app

To delete an app, add the value archive to the tags field (more info).

New app

Adding a JSON entry

New entries go to the end of the file

add-entry

At the end of contents.json, add an entry at }].

		"stars": 100
	}] // here
}

Insert a comma between } and ] and create a new entry with the format below.

Format

Feel free to cut and paste the snippet below

{
    	  	"title": "Name of the app",
    		"category": "Category name",
    		"description": "What this app does",
    		"source": "Link to source, usually GitHub"
	}

Details

title, category, description and source are required, the rest is optional.

{
		"title": "App name",
		"category": ["github", "parse"],
		"description": "Describe what this app does",
		"source": "https://github.com/user/repo",
		"homepage": "https://awesome-url",
		"itunes": "https://itunes.apple.com/app/id1234567890",		
		"lang": "zho",     
		"stars": 200,     
		"tags": ["swift"]
}

Examples

{
		"title": "Firefox",
		"category": ["browser", "official"],
		"description": "Official Firefox app",
		"source": "https://github.com/mozilla/firefox-ios",
		"itunes": "https://itunes.apple.com/app/firefox-web-browser/id989804926",
		"stars": 5641,
		"tags": ["swift"]
}
{
		"title": "VLC",
		"category": ["media", "official"],
		"description": "Media Player",
		"source": "https://github.com/videolan/vlc",
		"homepage": "https://www.videolan.org/",
		"itunes": "https://itunes.apple.com/app/vlc-for-ios/id650377962",
		"stars": 1753
}
{
		"title": "Simple Reader",
		"category": "hacker-news",
		"source": "https://github.com/rnystrom/HackerNewsReader",
		"itunes": "https://itunes.apple.com/app/simple-reader-free-open-source/id1000995253",
		"stars": 182
}

Thanks for contributing 🎉