~bzr-pqm/bzr/bzr.dev

2691.1.7 by Ian Clatworthy
Update doc indexes following discussion with poolie on IRC
1
=================================
2
Bazaar Developer Document Catalog
3
=================================
2481.1.4 by Robert Collins
Fix the developer documentation to use the right style sheet and give it its own index. (Robert Collins, Alexander Belchenko)
4
3383.2.1 by Martin Pool
Point to all developer documentation doc/developer/index
5
Bazaar user documentation is in the 
6
`Main Document Catalog <../index.html>`_.
7
8
Overall developer documentation
9
===============================
10
3408.1.6 by Martin Pool
Fix link to developer guide
11
* `Developer Guide <../en/developer-guide/HACKING.html>`_
3464.3.5 by Martin Pool
ReST tweaks and link back from HACKING to catalog
12
3683.1.1 by Martin Pool
Improved review process docs and separate out architectural overview
13
* `Architectural Overview <overview.html>`_ |--| describes some of the
14
  most important classes and concepts.
15
3995.5.2 by Martin Pool
Remove links to editable api docs; just point to generated ones
16
* `bzrlib API reference <http://starship.python.net/crew/mwh/bzrlibapi/>`_ 
3464.3.16 by Martin Pool
Point directly to API docs
17
  (external link)
3464.3.5 by Martin Pool
ReST tweaks and link back from HACKING to catalog
18
  |--| automatically generated API reference information
2534.1.1 by Robert Collins
Create a document describing bundles and their motivation.
19
3464.3.9 by Martin Pool
Add plugin and integration guides to doc indexes
20
* `Integrating with Bazaar <http://bazaar-vcs.org/Integrating_with_Bazaar>`_
21
  (wiki) |--| a guide for writing Python programs that work with Bazaar.
22
4144.5.5 by Eric Siegerman
Classify the new entries under (hopefully) appropriate sections.
23
* `Revision Properties <revision-properties.html>`_ |--| An application
24
  can set arbitrary per-revision key/value pairs to store app-specific
25
  data.
26
4070.10.12 by Martin Pool
Clearer developer doc link text
27
* `Testing <testing.html>`_ |--| Guide to writing tests for Bazaar.
3653.1.1 by Robert Collins
Move testing.txt to be with the other developers documents.
28
3464.3.9 by Martin Pool
Add plugin and integration guides to doc indexes
29
* `Writing plugins <http://bazaar-vcs.org/WritingPlugins>`_ (wiki) 
30
  |--| specific advice on writing Bazaar plugins.
31
2534.1.1 by Robert Collins
Create a document describing bundles and their motivation.
32
Process
33
=======
2481.1.4 by Robert Collins
Fix the developer documentation to use the right style sheet and give it its own index. (Robert Collins, Alexander Belchenko)
34
3778.2.1 by Martin Pool
Updated release process documentation.
35
* `The Bazaar Development Cycle <cycle.html>`_ |--| The monthly
36
  development cycle and how to run it.
37
  
38
* `Releasing Bazaar <releasing.html>`_ |--| 
39
  Checklist to make a release of Bazaar.
3383.2.3 by Martin Pool
Separate out and update the release manager instructions
40
3549.3.1 by Martin Pool
Updated instructions in packaging into the PPA
41
* `Managing the Bazaar PPA <ppa.html>`_ |--| Packaging Bazaar for Ubuntu.
42
3464.3.9 by Martin Pool
Add plugin and integration guides to doc indexes
43
* `Giving back <http://bazaar-vcs.org/BzrGivingBack>`_ (wiki) |--| How to get
44
  your changes to Bazaar integrated into a release.
45
2666.2.1 by Alexander Belchenko
change generated documentation extension from htm to html
46
* `Profiling notes <profiling.html>`_ |--| Instructions on how to profile 
47
  bzr code and visualize the results.
2534.1.1 by Robert Collins
Create a document describing bundles and their motivation.
48
4165.3.1 by Robert Collins
Various tweaks to ec2 stuff, and make it less windows only.
49
* `EC2 resources <ec2.html>`_ |--| A team resource for 
50
  Windows packaging and testing, and Ubuntu testing.
4012.2.1 by Martin Pool
Documentation on using EC2 Windows VM
51
2534.1.1 by Robert Collins
Create a document describing bundles and their motivation.
52
Plans
53
=====
54
2666.2.1 by Alexander Belchenko
change generated documentation extension from htm to html
55
* `Performance roadmap <performance-roadmap.html>`_ |--| The roadmap 
56
  for fixing performance in bzr over the next few releases.
2499.4.1 by Andrew Bennetts
First draft of container format developer doc, based on discussion with Robert.
57
4144.5.5 by Eric Siegerman
Classify the new entries under (hopefully) appropriate sections.
58
* `Co-located branches <colocated-branches.html>`_ |--| Planned(?) support
59
  for storing multiple branches in one file-system directory.
60
61
* `Bazaar Windows Shell Extension Options <tortoise-strategy.html>`_ |--|
62
  Implmentation strategy for Bazaar Windows Shell Extensions, aka
63
  TortoiseBzr.
64
4144.5.7 by Eric Siegerman
Add entry for improved_chk_index, which was recently added upstream.
65
* `CHK Optimized index <improved_chk_index.html>`_
66
2534.1.1 by Robert Collins
Create a document describing bundles and their motivation.
67
Specifications
68
==============
69
2666.2.1 by Alexander Belchenko
change generated documentation extension from htm to html
70
* `API versioning <api-versioning.html>`_ |--| bzrlib API versioning.
71
3418.5.1 by Vincent Ladeuil
Fix #183705 by updating the authentication docs regarding ssh agents.
72
* `Authentication ring <authentication-ring.html>`_ |--| Configuring
73
  authentication.
74
2666.2.1 by Alexander Belchenko
change generated documentation extension from htm to html
75
* `Bundles <bundles.html>`_ |--| All about bzr bundles.
76
77
* `Container format <container-format.html>`_ |--| Notes on a container format
78
  for streaming and storing Bazaar data.
79
3350.3.1 by Robert Collins
Draft up an interface for repository streams that is more capable than the
80
* `Repository stream <repository-stream.html>`_ |--| Notes on streaming data
81
  for repositories (a layer above the container format).
82
2666.2.1 by Alexander Belchenko
change generated documentation extension from htm to html
83
* `Indices <indices.html>`_ |--| The index facilities available within bzrlib.
84
3152.1.3 by Robert Collins
Resolve conflicts with bzr.dev.
85
* `Inventories <inventory.html>`_ |--| Tree shape abstraction.
86
87
* `LCA merge <lca-merge.html>`_ |--| A nice new merge algorithm.
88
89
* `Network protocol <network-protocol.html>`_ |--| Custom network protocol.
90
3246.6.1 by Robert Collins
Add a plugin-api.txt developer document starting to description services for/from plugins.
91
* `Plugin APIs <plugin-api.html>`_ |--| APIs plugins should use.
92
2666.2.1 by Alexander Belchenko
change generated documentation extension from htm to html
93
* `Repositories <repository.html>`_ |--| What repositories do and are used for.
94
3250.4.1 by Martin Albisetti
Added integration guide for developers
95
* `Integration Guide <integration.html>`_ |--| A guide to integrate bzrlib into
96
  any python application.
97
3794.5.33 by Mark Hammond
Add link to case-insensitive-file-systems doc.
98
* `Bazaar and case-insensitive file systems <case-insensitive-file-systems.html>`_
3932.3.1 by Martin Pool
merge cicp patch, correct rest syntax and news typo
99
  |--| How Bazaar operates on case-insensitive file systems such as commonly
100
  found on Windows, USB sticks, etc.
3794.5.33 by Mark Hammond
Add link to case-insensitive-file-systems doc.
101
4144.5.5 by Eric Siegerman
Classify the new entries under (hopefully) appropriate sections.
102
* `Development repository formats <development-repo.html>`_ |--| How to
103
  work with repository formats that are still under development.
104
  Contains instructions for those implementing new formats, of course,
105
  but also for (bleeding-edge) end users of those formats.
106
2592.3.229 by Martin Pool
Initial pack format documentation
107
Data formats
2535.4.31 by Andrew Bennetts
Tweak in response to review comments.
108
============
2592.3.229 by Martin Pool
Initial pack format documentation
109
3052.6.1 by Matt Nordhoff
doc/developers/index.txt: Fix link to pack docs.
110
* `Knit pack repositories <packrepo.html>`_ |--| KnitPack repositories 
2592.3.229 by Martin Pool
Initial pack format documentation
111
  (new in Bazaar 0.92).
112
4144.5.5 by Eric Siegerman
Classify the new entries under (hopefully) appropriate sections.
113
Implementation notes
114
====================
4144.5.3 by Eric Siegerman
List all documents that are neither linked to nor transcluded.
115
4144.5.4 by Eric Siegerman
Add descriptions to the new entries.
116
* `BTree Index Prefetch <btree_index_prefetch.html>`_ |--| How bzr decides
117
  to pre-read extra nodes in the btree index.
118
119
* `Computing last_modified values <last-modified.html>`_ for inventory
120
  entries
121
122
* `LCA Tree Merging <lca_tree_merging.html>`_ |--| Merging tree-shape when
123
  there is not a single unique ancestor (criss-cross merge).
124
4144.5.10 by Eric Siegerman
Rename a section heading.
125
Miscellaneous
126
=============
4144.5.4 by Eric Siegerman
Add descriptions to the new entries.
127
4144.5.5 by Eric Siegerman
Classify the new entries under (hopefully) appropriate sections.
128
* `dirstate <dirstate.html>`_ |--| An observation re. the dirstate file
4144.5.4 by Eric Siegerman
Add descriptions to the new entries.
129
130
* `"bzr update" performance analysis <update.html>`_ |--| "bzr update"
131
  performance analysis
4144.5.3 by Eric Siegerman
List all documents that are neither linked to nor transcluded.
132
2666.2.1 by Alexander Belchenko
change generated documentation extension from htm to html
133
134
.. |--| unicode:: U+2014
3464.3.5 by Martin Pool
ReST tweaks and link back from HACKING to catalog
135
136
..
137
   vim: ft=rst tw=74 ai