= Debathena = [[PageOutline]] Debathena uses [http://trac.edgewall.org Trac] for bug tracking, the developer wiki, and other project coordination. This Trac instance is also used for several projects related to Debathena, including: * [wiki:Linerva] * [wiki:Debothena] '''Logging In:''' In order to edit wiki pages or open bug reports, you need to Log in to Trac using your [http://ist.mit.edu/certificates MIT Certificate]. If you already have a certificate in your browser, click the Login link at the top right of the page to log in. == Bug Reports == Trac organizes bug reports into ''Tickets'', and we have further grouped them into ''Milestones''. Typically, a ''Milestone'' is created for each Ubuntu or Debian release. * [InProgressTickets tickets in progress]: [[TicketQuery(status=proposed|development|committed,format=count)]] * [OpenTickets open tickets (excluding "upstream" tickets)]: [[TicketQuery(milestone!=Upstream Utopia&status!=closed,format=count)]] * [RecentlyClosedTickets tickets closed in the last 60 days]: [[TicketQuery(format=count, status=closed,modified=60daysago,)]] * [/query all open tickets]: [[TicketQuery(status!=closed,format=count)]] === Opening a New Bug === To open a new bug, log in to Trac, and then click the "New Ticket" link in the top navigation bar. If the "New Ticket" link is not available, it means you're not logged in. == Joining The Project == Any member of the MIT Community is welcome to join the project. We periodically hold "cluedumps" or crash courses in Debathena development throughout the semester. Our next scheduled one is: * Date: TBD (IAP 2014) * Location: TBD * Time: TBD We also periodically hold "hackathons", where large groups of people get together to work on Debathena. These are ideal events for novice developers to attend, as there will often be a mentor who you can partner with to work on projects. We have identified some [HackathonTopics tickets that are ideal for hackathon work]. == Athena and Debathena Technical Overview == The Trac Wiki contains lots of technical information about Athena: * HowAthenaWorks * [wiki:Kerberos] (the primary authentication system used) * [wiki:AFS] (the global distributed file system where most data, including home directories, is stored) * [wiki:Hesiod] (the name service used for user names, group names, locker names, and more) * [wiki:NSS] ("Name Service Switch", allowing Linux systems to use multiple sources (e.g. /etc/passwd, Hesiod, LDAP) of information for system "names") * NssNonlocal * [wiki:PAM] ("Pluggable Authentication Modules") * [wiki:Lockers] * [wiki:Moira] * AthenaDotfiles * ClusterConfig * [wiki:Printing] * [wiki:Installation] * [wiki:PXEInstall] * AutoUpdates * AutoUpgrades * [wiki:Larvnet] * [wiki:Athinfo] == Debathena Project Policies == * The [[CollaborationPolicy]] outlines collaboration between SIPB and IS&T. * The [[MetapackagePolicy]] provides guidelines concerning the functionality of each metapackage. * The [[WorkflowPolicy]] describes how code is committed, tested, and deployed. * RepositoryBestPractices * The [[ReleaseSupport]] policy describes the timeline and guidelines for how long Ubuntu and Debian releases are considered "supported" by the Debathena project. == Developers == === Testing === * TestPlan * PrintingTestPlan === Contributing === * ProjectOverview * GettingStartedWithDevelopment * CaffeinatedSubversion * CaffeinatedMake * [wiki:AnatomyOfAPackage] * [wiki:Changelog] * [wiki:Copyright] * CompatLevels * MaintainerScripts * WhenToUseTheStupidTildeInVersionNumbers * ConfigPackageDev * [wiki:Debathenification] * [wiki:ConvertingToAutomake] * [wiki:Manpages] * [wiki:BuildingATestPackage] * [wiki:LiveCD] === Building official packages === (Most of the things in this section require debathena-root level access) * WorkingWithTheRepository * WorkingWithGithub * CommittingYourChanges * BuildingAndUploading * [wiki:AddingANewPackage] * [wiki:BuildingATestPackageOnAllPlatforms] * [wiki:CustomControlFields] * [wiki:UpgradingChroots] * [wiki:APTRepositoryManagement] * [wiki:PackageNotes] === Release Engineering === * Technical Information: * [wiki:BuildSystemDetails] * [wiki:GitRepositoryDetails] * [wiki:ListsGroupsACLsAndServers] * [wiki:TheMetapackages] * BootstrappingTheProjectInfrastructure (this article name sucks) * [wiki:UpdatingTheAPTRepository] (do we even do this)? * [wiki:SettingUpABuildServer] * [wiki:RemovingABuildChroot] * [wiki:RemovingADistFromTheAPTRepository] * [wiki:SettingUpACanonicalBuildArea] * [wiki:AddingOrRebuildingASuite] (i.e. Supporting a new distro) * [wiki:MaintainingAutodebathenify] * [wiki:APTRepositoryHTTPServerSetup] Finally, you can also see a list of [TitleIndex all pages in our wiki] and [InterMapTxt the mappings defined to link to other wikis].