doc: mention haddocks
This commit is contained in:
		
							parent
							
								
									0f2b95041e
								
							
						
					
					
						commit
						caff99637b
					
				
							
								
								
									
										12
									
								
								doc/README
									
									
									
									
									
								
							
							
						
						
									
										12
									
								
								doc/README
									
									
									
									
									
								
							| @ -18,7 +18,11 @@ doc/profs/        a place for long-term profiling/performance data | |||||||
| README.md         the main project readme, displayed on github | README.md         the main project readme, displayed on github | ||||||
| LICENSE           the default project license | LICENSE           the default project license | ||||||
| 
 | 
 | ||||||
| 3. Per-package descriptions, readmes, changelogs, and reference manuals. | 3. Code/API docs in haskell source files as haddock comments: | ||||||
|  | 
 | ||||||
|  | hledger*/**/*.hs  haddock module and function docs in most source files | ||||||
|  | 
 | ||||||
|  | 4. Per-package descriptions, readmes, changelogs, and reference manuals. | ||||||
| These are in the respective package directories: | These are in the respective package directories: | ||||||
| 
 | 
 | ||||||
| hledger*/package.yaml    source for package metadata (description, etc.) | hledger*/package.yaml    source for package metadata (description, etc.) | ||||||
| @ -26,13 +30,13 @@ hledger*/README          package readme, displayed on hackage | |||||||
| hledger*/CHANGES         package changelog, displayed on hackage | hledger*/CHANGES         package changelog, displayed on hackage | ||||||
| hledger*/hledger*.m4.md  package manual source file(s) | hledger*/hledger*.m4.md  package manual source file(s) | ||||||
| 
 | 
 | ||||||
| 4. The project website and additional docs - home page, FAQ, tutorials,  | 5. The project website and additional docs - home page, FAQ, tutorials,  | ||||||
| how-tos, developer guide, etc. These are in the site directory: | how-tos, developer guide, etc. These are in the site directory: | ||||||
| 
 | 
 | ||||||
| site/             hledger.org website content, templates, assets | site/             hledger.org website content, templates, assets | ||||||
| 
 | 
 | ||||||
| 
 | 
 | ||||||
| Workflows: | ## Workflows | ||||||
| 
 | 
 | ||||||
| The manuals and website are rendered from the top directory,  | The manuals and website are rendered from the top directory,  | ||||||
| primarily using Shake. First, build Shake: | primarily using Shake. First, build Shake: | ||||||
| @ -78,7 +82,7 @@ $ make site-reload | |||||||
| $ open http://localhost:8001  # if the make file didn't do it | $ open http://localhost:8001  # if the make file didn't do it | ||||||
| 
 | 
 | ||||||
| 
 | 
 | ||||||
| Misc. notes: | ## Misc. notes | ||||||
| 
 | 
 | ||||||
| Changelogs are plain text, but started including some markdown formatting | Changelogs are plain text, but started including some markdown formatting | ||||||
| from 1.0. Should make consistent. | from 1.0. Should make consistent. | ||||||
|  | |||||||
		Loading…
	
		Reference in New Issue
	
	Block a user