WowAce.com Knowledge base

Projects / Getting Started with WowAce

r8

Creating a new project

Go to the home page and click "Create a new Project" near the top.

You'll see a big, scary form with lots of fields.

Name
Choose a name for your project. This can be anything. Try to be original but also declarative.
Short Name
This is a unique identifier for your project. This will be unique for all of WoW, including all projects on CurseForge. This is what shows up in all urls as well. Must be all lowercase letters, numbers, -, and _.
License
There are many open source licenses to choose from, as well as Public Domain and No license (All rights reserved). You may also specify a custom license. If you believe a custom license deserves to be standard, just report it or tell an admin.
Category
Choose up to 5 categories that your project falls under. Worst case scenario, go with Miscellaneous.
Localized Languages
Choose which languages that your addon has been translated into already. If your addon has no translations, just choose English.
Description
This is the description of your project. A feature list is good here.
Do not state that your project is similar to another project without describing what it actually does.
Comments
Whether you want to have comments available on your project.
Bugtracker
Whether you want to use WowAce's provided bug tracker.
Clonability
Whether a non-author can clone your project's mainline repository to do their own hacking. All open-source licenses require full clonability. For information on cloning, see [[kb:projects/cloning|Cloning]].

Fill out all this information and you should be golden.

Our moderators will decide whether to approve your project or not, and if they do approve it, the general public will be able to view your project. For information on approval, see [[kb:policy/project-acceptance-policy|Project Acceptance Policy]].

Claiming an existing project that ''is'' yours

If your an author and your project is not assigned to you, we apologize, our importation script has limited effectiveness in this due to there not being a real user system on the old site.

To claim the project simply go to the project's new details page and click "Report Project" on the right sidebar. Fill in the details and we'll resolve the issue as quickly as possible.

Claiming an existing project that seems abandoned

Please read the [[kb:policy/abandoned-and-inactive-projects/|Abandoned and Inactive Projects Policy]].

Editing an existing project

Go to the project page you want to go to, on the right-hand side, there will be "Edit Project".

You can change most of the same data as in creating a project.

There are two things that you can't change from this view:

Short name
Report your project or tell a moderator that you want your short name changed.
Description
On the project page, click "Edit Description" on the right. Also see [[kb:projects/changing-descriptions/|Changing Descriptions]]

Setting up your repository

If your project was imported from the old WowAce, your SVN repository should be set up and ready to go for you already.

Otherwise, go to your project, go to Repositories, click Edit Repository, set the type you want (SVN, Git or Hg) and any other details.

Set up your SVN password and/or SSH key. Go to Your Repository Authorization page.

See the [[kb:repositories/repository-faq/|Repository FAQ]] for more in-depth details.

Important Note: WowAce does not allow zip file uploads, unlike CurseForge.

Handling libraries/externals

In the old WowAce, you'd stick your library references into svn:externals.

With the new one, in order to support git and hg, we've moved to a repository-neutral system, [[kb:projects/pkgmeta-file/|.pkgmeta file]].

You can still set svn:externals, but it will only affect those who checkout from svn, the packager never looks at that. Also, you'd limit yourself to only SVN-based externals.