|
FAQ
Project Hosting on Google Code FAQ
Other FAQs: Sections:
Getting StartedWhat's the new project-hosting service on Google Code?Our new hosting service offers a collaborative development environment that includes:
Who's the service for?All open source developers. If you plan to start an open source project, we encourage you to create a project on Google Code. Why is Google offering to host open source projects?One of our goals is to encourage healthy, productive open source communities. Developers can always benefit from more choices in project hosting. Is hosting on Google Code available internationally?For now, project hosting is available only in English. Open source projects can be created by developers from all countries, with a few small exceptions. Will Google Code be localized into my language?We plan to localize Google Code as it matures. Is Google Code's implementation itself open source?As with most project-hosting sites, our underlying technology is a mixture of open source and proprietary code. For example, the issue tracker is entirely written by Google, but the version-control service is based on Subversion, a popular open source tool. Where's the documentation for the project-hosting service?Much of it's right here in this FAQ. Also, most project and issue tracker pages contain self-documenting fields that describe the purpose of the page. For documentation on how to use a Subversion client, just visit the Subversion project. How is this project-hosting service related to Summer of Code?Both are part of our larger initiative to support and encourage the development of open source software. Google Summer of Code projects may also be hosted on Google Code, should the student or mentor so wish. Hosting Your Open Source Project on Google CodeWhy would I want to host my open source project on Google Code?Our project-hosting service is simple, fast, reliable, and scalable, so that you can focus on your own open source development. Why would I not want to host my open source project on Google Code?Google Code will have lots of key features at launch, but we may not have all features you want or need for your project. Rather than try to offer every possible feature, we have focused on doing the most important things really well. More features will be added over time, but only when they are ready. However, we will not offer the following any time soon: shell accounts, build farm, private projects, nested projects, or multiple alternatives for each type of hosted tool. Are there any restrictions on who can use the site?Just a couple. You'll need to be in a country where Google is able to conduct business, and your project needs to be open source. Do I need to have a Gmail account to start a project?No, a Gmail account is no longer required to create a project, though you will need a Google Account. If you don't have a Google Account already, you can create one now. Do I need to have a Gmail account to participate in a project?No authentication is required to browse project pages or issues, or to check out source code. To create or comment on an issue, though, you'll need to be logged in to your Google Account. To manage issue metadata or commit to a project's Subversion repository, you'll need to be logged in to your Google Account and have either an owner or a committer role. Are you going to put ads on my project page?No. Ads aren't part of Google Code at this time. Can I put ads on my project's pages?This may be an option in the future, but, no, not for now. How long does it take for my project to be approved for hosting?As soon as you create a project, it's available for use. Can I use Google Code to host projects that aren't open source?Nope. Open source projects only. Why open source projects only?Most proprietary software projects have funding, and can therefore afford to pay for commercially offered development tools and environments. The goal of hosting on Google Code is to promote healthy open source development by offering hosted tools that most open source projects can't afford. What should I do if somebody took my project's name?We rely on the goodwill of open source participants to ensure they are the rightful owner or creator of a project name. If you feel that someone has intentionally created a project that uses your existing project's name, please contact us via our Google Group or email google-code-hosting@googlegroups.com directly to discuss the situation. How do I create a project?A good project starts with a good idea: one that addresses a real need, is feasible and well-scoped, and isn't well covered by existing open source projects. (Before you create a new project, we suggest that you try searching for existing projects on this site and elsewhere on the web. You can often get further faster by helping out with an existing project than by starting one from scratch.) If you're ready to start your own project, you'll need to write a description of it and give it a good name. The project name will have to have more than 2 characters and must be lower case. Then, sign in using a Google account, enter that information into the Create a project page, and you're done. Congrats. You've got a brand-new project on Google Code. How do I join a project?One of the project owners must use the project administration page to add your Google account email address to the project. Most projects have mailing lists that the developers use to discuss the project. To become a developer, first participate on the mailing list by showing your interest in the project and your ability to help the project. Then, ask the project owners to make you a member of the project. Hosted ToolsWhy do you only offer a small set of licenses?The open source community has been flooded with lots of nearly identical licenses. We'd like to see projects standardize on the most popular, time-tested ones. The selected licenses offer diversity to meet most developer needs. How can I select a license other than the ones provided?At this time, we offer only the licenses listed. How can I choose two licenses for my dual-licensed project?At this time, we offer single licenses only. Can I host code that I have placed in the public domain?The concept of "public domain" is actually a lot more complicated than most people realize. Holding copyright and using a (permissive) licence is almost always the right choice. In general, we do not offer to host projects with source code in the public domain. However, if you can only release your code as public domain, and you are sure that you can legally do so, please enter an issue for us to review your request and create the project for you. Is my data safe?Yes. Your data is hosted on Google's infrastructure in Google's datacenters, ensuring a high level of reliability and redundancy. How do I get a copy of my data?At this time, there aren't any import or export features. But look for them as the service matures. How do I create web pages for my project?You can use Google Sites to create web pages, and then create a link to them from your project's front page. Google Docs is another great way to collaboratively create documents and publish them on the web. Or, link from your project to any existing web pages. Can I use another hosting service for parts of my project?Yes. If Google Code doesn't have all the tools you need, feel free to start with Google Code and use a combination of tools from this site and others. Use hyperlinks on your project summary page to guide your users to these other resources. What other limits exist?There are disk-space quota limits for both issue tracker attachments and total Subversion repository size, along with a limit on how many total projects you are able to create. If you hit these limits, please contact us via our Google Group or email google-code-hosting@googlegroups.com directly to discuss the situation. How can I integrate my project blog?You can use a gadget. Click Administer, then edit your project description to include: <wiki:gadget url="http://google-code-feed-gadget.googlecode.com/svn/trunk/gadget.xml" up_feeds="http://google-code-featured.blogspot.com/atom.xml" width="780" height="340" border="0" up_showaddbutton="0"/> But, replace the up_feeds URL with a the XML feed for your blog. If you have more than one project blog, you can list multiple URLs, separated by vertical bars (|). Why aren't you offering my favorite tool?We want our collaborative development environment to be simple, fast, reliable, and scalable, so we only offer tools that are aligned with those goals. This way, we can manage and support the tools we offer in a scalable manner. If you need more tools, you might choose to run them yourself on your own servers, or you might make use of individual tools that are offered by other project-hosting sites. You can loosely integrate with other tools and websites by linking to them from your project-summary page. Google GroupsWhat is a Google Group?A Google Group is a mailing list hosted at groups.google.com. Each Google Group has an extensive web interface, but you are also perfectly welcome to use it as a plain-old mailing list. Does creating a new project on Google Code automatically create a Google Group for me?No. Google Code offers the ability to send issue tracker and Subversion commit emails to mailing lists of your choice, but it doesn't create those mailing lists for you. How do I create a mailing list for my project?You can visit Google Groups and create as many mailing lists as your project needs. We recommend that you create at least two lists: one for developer discussions and one to receive Subversion commit emails. Can I use an existing mailing list with my project?Sure. Just link to its existing web interface using a regular project link. If you have an existing mailing list for automated commit messages, enter its address in the form that is under the "Administer" tab. How do I make my mailing list accept Subversion commit emails?Simply configure your mailing list to accept posts from PROJECTNAME@googlecode.com. You can do this by adding the address to the "allowed posters" list, or by making that address a member of the list with no delivery. Other QuestionsWill my project appear in Google Web Search?At the moment, no. It will only appear in the search results of the search box at http://code.google.com. In the future, however, your project is likely to appear in Google's main index. Will hosting my project here improve its PageRank?No. Your PageRank will only improve if other websites think your project is important and link to it. How do I import my project from SourceForge, Tigris, or another site?We have no import feature at this time. What technology does the site use for its operation?Like most Google products, the site is built on scalable Google infrastructure and uses AJAX for the user interface. The issue tracker is written in Python, and uses Google's free-text search technology. The Subversion server is based on the standard open source product, with changes to run on Google's infrastructure. If I find a problem with the hosting on Google Code, how do I file a bug?Visit the user support issue tracker. Check whether an appropriate issue has already been created, and if not, create one yourself. How do I file a feature request for Google Code?Visit the user support issue tracker. Check whether an appropriate issue has already been created, and if not, create one yourself. What information does Google Code collect about users?Check the Google Code Terms of Service for more information, with specific reference to our privacy policy. What measures is Google Code taking to protect the privacy and security of people's information?Privacy and security are extremely important to us. Google Code uses your Google or Gmail account for authentication. For Subversion authentication, a secondary generated password is used. Logs of your activities are not released to any third parties. For more info, please check out our Terms of Service. I'm new to open source... how do I run an open source project?If you are new, you should plan to participate in existing open source projects to learn how they work. You might also want to check out Karl Fogel's book, Producing Open Source Software. Is Google Code going to integrate with other Google products?To some extent it already does. For example, it uses Google Accounts for authentication, and the issue tracker uses Google's search technology. Look for more integration with other Google products as the site matures. I found a project that's not open source. Who do I notify?please contact us via our Google Group or email google-code-hosting@googlegroups.com directly to discuss the situation. How do I report a DMCA violation?Please read the Google Code Terms of Service, then follow the instructions on our DMCA page. How do I report abuse of Google Code site?please contact us via our Google Group or email google-code-hosting@googlegroups.com directly to discuss the situation. The content on this page created by Google is licensed under the Creative Commons Attribution 3.0 License. User-generated content is not included in this license. |
Sign in to add a comment
If you want membership in a project, you must contact the project owner via email. Leaving a comment on this site-wide FAQ page will not help you.
Participating in the project mailing list is a good idea before requesting membership. Once you have done that, you can ask for membership on the project mailing list and the project owner should see your message.
If the project does not have a mailing list, then try contacting the project owner directly. If the full username is shown, you can email them at USERNAME@gmail.com.
If there is no mailing list and all project owner and member username look like usern...@domain.com, then you can consider leaving comments on an appropriate project wiki page, or filing an issue in the project.
"At this time, we've tested compatibility with Mozilla Firefox 1.0.4 and 1.5, Safari, and Microsoft Internet Explorer 6.0 and 7.0 beta 3. "
Seriously?
Subversion 1.4.0?
Ironic that, according to the FAQ, it's not compatible with Google Chrome, Google's own browser.
ggreif: Good catch; we've actually been on 1.5.4 for some time now (and will be on 1.6 soon, though 1.6 doesn't have much in the way of server-side changes).
So if the subversion respository quota is 100MB by default, is there any way to see how much of that a project is currently using?
peter: We only host open source projects. If you are just shy about other people seeing your code, don't worry about it, everyone's code starts off very rough. We host some really good open source project, but we also host a ton of really bad ones, so yours could not possibly be the worst :). If you want it to be closed source to keep some security secret, that probably won't work out well anyway.
I couldn't get the steps given above for How do I download my Subversion history to work on windows xp(sp3). Instead I had to create the batch file, pre-revprop-change.bat in the hooks directory of the local repos:
This will allow user 'averagejoe' to do revprop changes. Of course, 'avergejoe' needs to be replaced with the relevant USERNAME.
My project involves source code written in a weird language that is not understood by the syntax colorizer used in the subversion browsing UI. Is it possible to write some sort of plugin that can do this? I have my own colorizer and ANTLR grammars for this language, not to mention copious "free" time.
Members of my Project can not check out by TortoiseSVN.It thrown error "OPTIONS of 'https://myproject.googlecode.com/svn/trunk': authorization members". How to resolve it.Please help me.
I'd like to submit art for a google theme. what are the art specs, and how do I go about it? many thanks Ros ros345@sbcglobal.net
is it possible to host parts of documentation on CC-BY-SA-NC? instead of CC-BY-SA?
I'm getting a google server error when I click on the "Source" tab. Anybody else seeing this?
I found out that you can't really change between Subversion and Mercurial as easy as it seems to be.
I got some nasty errors when trying to browse my code and edit wiki pages. Just wanted to notify it somewhere. I should probably mail Google somehow and notify them on the problem.
Do you provide some basic statistics for project, for example svn traffic, web traffic and so on? Any gadget can do that?
zexspectrum, you can sign up for Google Analytics and then enter your Analytics account number on the Administer tab in your project. That measures web traffic only. Also, downloads show a count of the number of times each file was downloaded.
jrobbins, thanks for the answer. Using Analytics is good if you are a project owner. But is there any way to display project stats for non-members? For example, sourceforge.net has Project Statistics on Project Summary page. Can I place Google Analytics gadget on my project's summary page and show traffic to non-members?
thanks for my answer
You guys just like to mark everything as spam, don't you.
How can Imdelete the gadgets that do want have on my Google screen?
如何删除项目和改名
You say that you only support a limited number of open source licences, but I can't find any list of which ones those are. Where is the list, please? (I would have expected a link from the FAQ entries.)
I want to delete my project. How do I go about this?
Someone marked my project as "not open-source". Of course, it isn't open source, but can someone get back to me and either have it removed or unspam it?
Is there a way to quit a project?
I tried to set up a google group for the commit notices, but was unable to do so. There is no "allowed posters" list, as the FAQ implies. And I could not set codesite-noreply@google.com as a member of the list. What is the solution?
I have a question, I want to use this not for programming purposes, but for a translation group I have, I find the system incredibly useful and it's worked wonders on our project. We're basically using it to host subtitle files, jpegs, txt's and things like that, I don't need to say that there's absolutely no copyrighted material in it. Is it okay if we use Google Code for it?
The answer to the question: "How do I make my mailing list accept Subversion commit emails?" might be quite old... It says: "...? accept posts from codesite-noreply@google.com. You can ...?" When I did set something like it up in google-code, it gave me a different address, which was specific for that application.
for tortoise, first create a directory where you want to work. right click on it, select checkout. http://yourproj.googlecode.com/svn/ now you are at rev 1. copy files into trunk, right click and add trunk right click to switch to https://yourproj.googlecode.com/svn/ use your google or gmail name/email and the google code password from your personal google settings page. add a commit message, copy and paste it into a notepage because you may have to enter it again if something goes wrong. what pain figuring all this out... if you start w/https:// you need auth just to view it... auth can be wrong, it isn't obvious what user name or password will work. no doubt by posting this simple info someone will now know a better way. shouldn't have to look through 10 pages to get the details. but hope it saves you a few mouse strokes.
I have add some members to the project committers (Administrator -> Project members tab) but they can not check out the project. Just the owner with generated pass can check out. What is my problem?