Skip to content

Developer Guide

Jump to bottom Edit New page
Amadeusz Sadowski edited this page Mar 23, 2014 · 30 revisions

Home page

####Content####

###Quick setup###

Here I assume you're a member (not a member?(dead link)). First:

  1. Turn off automatic updates.
  • Why? It's too automated. Might lead to chaos. More...
  • How? BattleScribe Editor (Catalogue or Roster) -> Manage Data -> uncheck "Check for new data files on startup?"
  1. Open GitHub app.
  2. Open BSData repo list.
  • You have a list on right. There is your profile and all organisations you are member of.
  • Choose BSData.
  1. Clone repos.
  • For each repo you want to develop, right-click -> "Clone to..." -> choose "BattleScribe/data" folder.
  • You can find it in BattleScribe -> Manage Data on the bottom: ie. "Data location: C:/Users/Amadeus/BattleScribe/data"
  1. Now we can actually start developing!

###Development cycle###

If you're part of our organisation (not a member?(dead link)), you can directly commit changes. Here's how:

  1. Open GitHub app.
  2. Open local repo you'll work on.
  • on left side you have "Local" headline. Just under it click "repositories"
  • choose the repo you want to work on
  1. Click the cog symbol, "View on GitHub".
  • this will open the webpage of the repository
  1. Browse Issues.
  • check out Issue Guidelines
  • use label & milestone filters.
  • choose which one to work on.
  • if you want to do something not already listed, create new Issue
  1. Sync
  • click "sync" in upper right corner
  • you really want to work on newest version of file. Believe me.
  1. Work! :)
  2. Commit you hard work for community (& yourself).
  • check for errors ;)
  • click "Uncommited changes" in GitHub app
  • enter summary - mention # of issue you were working on. (ie. Vespids stats updated, #12)
  • click "Commit to master"
  1. If you've finished for today, sync. If not, go back to bullet-point 4.
  • only after you click "sync" will your changes be uploaded to GitHub servers

Read on! Then there's the release mechanism.

###Releasing###

GitHub repository is one thing, but publication is another. People with auto-update link download the so-called latest release. That is a tagged version, a moment in commit history. After release, all further changes are on top of that, and will be included in next release.

####How to release####

So you've decided the new version of repo is ready to be publicated. Now:

  1. Go to home page of your repo. ie. in GitHub app open repo, click upper right cog, "View on GitHub".
  2. In a single line you have numbers of "commits", "branches", "releases" and "contributors" Click releases
  3. There you see last releases. Click "Draft a new release".
  4. Tag your version. Our convention:
  • v3.5.12 will be for third general revision (big changes), after fifth update (ie. new Catalogue etc), and we (community) have made twelve little bug-fixes since then.
  • first number won't change often. It will change when new Rulebook comes out, or we add entirely new something for everyone
  • second number will change whenever you decide the release involves more than bug-fixes and little improvements.
  • third shall be changed most often. Don't be scared, release doesn't cost you anything besides a minute.
  • of course after changing first or second number, further numbers are zeroed. So if new file was added after v6.15.8, we call our's v6.16.0.
  1. Enter title. Say what generally changed.
  2. If you feel like detailing, why not.
  3. Publish release.

###Auto-updates###

You can turn on updates for games you don't develop for, because each game has it's own folder. So just subsribe to them. But make sure these repos don't contains files for game system you develop for - that will, again, lead to chaos. Seriously.

###Further reading###

[Guidelines and conventions] (https://github.com/BSData/bsdata/wiki/Home-page#guidelines-and-conventions)

Add a custom footer
Add a custom sidebar
Clone this wiki locally