Re: [Csnd-dev] [EXTERNAL] Re: [Csnd-dev] Manual for Csound 7

hi menno -

i am a bit puzzled how this does or does not refer to what we have 
currently in https://csound.com/manual/

what i like in your overview is that the main sections are more clear.
i am wondering whether we can also put Opcodes Index, Opcodes Quick 
Reference and GEN Routine Index in another big section called "Index and 
Quick Reference".  then it would be:

Introduction
Csound System
Opcode Overview
GEN Routine Overview
Utility Programs
Index and Quick Reference
Appendix

ciao -
	joachim


On 16/04/2025 11:01, Menno Knevel wrote:
> Hi all,
> i sat down and took a moment to reflect on how to get a more transparent manual index; what is shown to the user when looking at the Csound Manual.
> So, continuing the path of the present beta Csound7 manual https://csound.com/manual/, i came up with re-distributing of some chapters and simplifying the start screen . The tree of the manual has a max depth of 3.
> 
> I can not attach anything in this list, so i hope the copy-paste of my .odt is without error.
> 
> Feedback appreciated.
> 
> ==============================
> 
> 
> Introduction
> 		What’s new
> 		Historical
> 				Preface
> 				Manual
> 						Nomenclature
> 		Copyright/ Links		
> Csound System
> 		How Csound Works
> 		Configuring
> 		Real-Time Audio
> 		The ‘csound’ Command
> 		The ‘csd’ File Format
> 		Csound Options (flags)
> 				Alphabetically
> 				By Category
> 		Guard Point in Tables
> 		Environment Variables
> 		Order of Precedence
> 		UDP Server
> 		Syntax of the Orchestra
> 				Header Statements and Global Space
> 				Instruments
> 				Data Types and Variables
> 				Macros
> 				User Defined Opcodes (UDO)
> 				Traditional and Functional Code
> 		Syntax of the Score
> 				Parameter Fileds
> 				Durations in Instrument Events
> 				Amplitude Values
> 				Preprocessing
> 				List of Statements
> 				Macros
> 				Included Files
> 				Expressions
> 				Scripts
> 				Csbeats
> Opcodes Overview
> 		Signal Generators
> 		Signal Input/Output
> 		Signal Modifiers
> 		Instrument Control
> 		Functional Table Control
> 		Mathematical Operations
> 		Pitch Converters
> 		Real-Time MIDI
> 		Spectral Processing
> 		Strings
> 		Vectorial Opcodes
> 		Zak Patch System
> 		OSC, Network and non-MIDI deveices
> 		Signal Flow Graph Opcodes
> 		Mixer Opcodes
> 		Miscellaneous Opcodes
> GEN Routine Overview
> Utility Programs
> 		About
> 		Analysis File Generation
> 		File Queries
> 		File Conversion
> 		Other Csound Utilities
> Opcodes Index
> Opcodes Quick Reference
> GEN Routine Index
> Appendices
> 		List of Examples
> 		Pitch Conversion
> 		Sound Intensity Values
> 		Formant Values
> 		Modal Frequency Ratios
> 		Window Functions