|
|
||||||||||||||||||||||||||||||||||
|
New! You can now use the Article Submission Wizard to post your articles directly onto the site. Introduction Do you have some cool code you want to share?Sharing code with others is a great way to not only help others, but also to become a better programmer. With many thousands of people downloading your code you will not only get a lot of positive feedback, but also bug fixes, free testing, and more often than not, suggestions on how to make the code even better. It also encourages others to share their code, which in turn gives you access to an even larger base of free source code. If you post to CodeProject then you retain copyright of your article and code. You also give CodeProject permission to use it in a fair manner and also permit all developers to freely use the code in their own applications. Note that we do not accept time limited or shareware contributions: All code that is available from our site must be available for use for free. Preparing your codeIf you have some great code, but do not make it easy for others to use it, then more often than not people will pass it by and not use it. We suggest:
Submitting your codeWhen submitting your code and article please check you have the following:
Package all this up into a single zip file and send it to submit@codeproject.com. When emailing the article please state the title of the article in the subject line. Also if you think it neatly fits in one of the categories, please let us know. The ArticleFirst and foremost, we need some documentation. This doesn't have to be anything fancy, though we don't mind if it is, but if you think about answering the following questions then you should be off to a good start.
The idea is to give the reader a clear of idea of the purpose of your code, instead of forcing them to download a project, build it and then hunt around to find out what the sample does. The quickest way to get your code posted is to provide a simple HTML file. Our preferences on documentation are:
Please try and avoid using MS Word to produce your HTML. Even plain text is better than this! All the articles at CodeProject.com have the same look and feel which is achieved by only the most basic HTML features. If you send us a HTML file with different fonts and colors and fancy bits, chances are it will all be stripped out to make it conform to the CodeProject standard. All documentation is edited by hand, so it can be a real nightmare wading through masses of horrible HTML produced by such things as MS Word. The Zip filePlease ensure that you zip all files up using maximum compression, and remove all unnecessary files (*.opt, *.ncb, *.obj, *.aps, *.plg, etc.) from the project folders. If possible, please keep submissions below 300Kb. File naming convention: If your contribution comprises a HTML article,
source code and an image, then to make life easy for us we ask that you follow
the following filename conventions. Suppose your article is called coolcode.html.
The filenames should be of the form:
Alternatively, if you have source code, a demo project and a number of images, then your filenames would be along the lines of:
BTW, don't use the name coolcode, try to find something more relevant :-) Sourcecode GuidelinesFirst and foremost, does the code actually work? We do sometimes get code that, for one reason or another, just does not work. Please check that the source code you send compiles cleanly, and if part of a larger demo application, that the application itself runs OK. We do ask that the general MFC guidelines be adhered to so that other programmers can understand your code easily. Conventions that help other programmers read your code are:
Also, does the code compile cleanly under the warning level 4? Sample ProjectSample Executable: If providing a sample executable, please make sure it is linked with the release libraries (e.g. Make sure it is not linked with the Unicode or debug libraries). The whole point of a demo executable is to give developers a quick intro to your code. If they have to recompile in order to get the application to run on their system then there is no use in supplying the executable in the first place. Secondly try to conservative about just how big a sample you upload, a 4Mb sample just isn't going to interest a lot of people. Sample Project:It is recommended that you also include a sample project. When creating a zip file for the sample project, please do not include either the Debug or the Release directories. They simply inflate the size of the ZIP file. Also, do not include the *.clw, *.ncb, *.opt and other such files that are automatically recreated. Submitting an article based on another persons workIt is OK to use others code as a base as long as you make it totally clear that some/most of the code isn't yours. If you use someone else's code then DO NOT remove their copyright notices. There is a lot of code reuse here, that's the point after all. As far as the articles that are being posted here we expect to see credit where credit's due, in the code and the HTML as appropriate. If you are submitting a modification, extension or correction to another persons work then we ask that you attempt to contact the original author first and then try to liaise with him/her to produce an update to the original article. This way we can retain continuity with the original article as well as reducing the number of completely new pages that need posting. Submitting code already posted at another siteYou are more than welcome to submit code that is already published at another site, provided you own the copyright on that article, and provided you have not given the other site exclusive rights to your article. The Code Project Submission TemplateThe template zip file contains two templates for use when submitting articles to The Code Project. We recommend editing these files using DevStudio or some other text editor (Visual Interdev is excellent). All extraneous formatting will be removed. You only need to fill in ONE of these files: If you are comfortable with editing ASP, then please use the .ASP template. If you wish to edit your articles in a way that allows you to preview the results, then use the .HTML template. The ASP template is better for us, but the HTML may be easier for you. If you use the HTML template then it will not look like the final product - it has been formatted to allow the relevant information to be entered as quickly and easily as possible. Using these templates will help us post your article sooner. We are using MS IIS and ASP pages on the server, allowing us to simplify the templates used to create the articles. To fill in either of these templates, just follow the 3 easy steps below:
That's all there is to it! All formatting will be done by the ASP script engine.
|