> For the complete documentation index, see [llms.txt](https://poshcode.gitbook.io/powershell-practice-and-style/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://poshcode.gitbook.io/powershell-practice-and-style/style-guide/introduction.md).

# Introduction

## Introduction

In the Python community, developers have a great programming style reference provided as part of the language enhancement process specifications ([PEP-8](https://www.python.org/dev/peps/pep-0008/)), but in the PowerShell world there has been no official documentation of community preferences.

This document is an attempt to come to an agreement on a style-guide because we know that the more people follow the same set of code-style habits, the more readable the community's code will be. In other words, although the recommendations of this guide are *just recommendations*, if you follow them, you will write PowerShell code that is more easily read, understood, and maintained.

## Table of Contents

* [Code Layout and Formatting](/powershell-practice-and-style/style-guide/code-layout-and-formatting.md)
* [Function Structure](/powershell-practice-and-style/style-guide/function-structure.md)
* [Documentation and Comments](/powershell-practice-and-style/style-guide/documentation-and-comments.md)
* [Readability](/powershell-practice-and-style/style-guide/readability.md)
* [Naming Conventions](/powershell-practice-and-style/style-guide/naming-conventions.md)