Linting and markdown

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+max_line_length = 120
+trim_trailing_whitespace = true

.github/workflows/linter.yaml

@@ -0,0 +1,14 @@
+name: Linter
+on:
+  pull_request:
+  push:
+    branches: [main]
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+      - uses: pre-commit/[email protected]

.github/workflows/pages.yml

@@ -1,19 +1,15 @@
 name: Deploy to Pages
-
 on:
   push:
     branches: ["main"]
   workflow_dispatch:
-
 permissions:
   contents: read
   pages: write
   id-token: write
-
 concurrency:
   group: "pages"
   cancel-in-progress: false
-
 jobs:
   deploy:
     environment:
@@ -23,12 +19,16 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4
+      - uses: docker://pandoc/core:3.1.1.0
+        with:
+          args: >-
+            --standalone --template=template.html --output=index.html README.md
       - name: Setup Pages
         uses: actions/configure-pages@f156874f8191504dae5b037505266ed5dda6c382 # v3
       - name: Upload artifact
         uses: actions/upload-pages-artifact@a753861a5debcf57bf8b404356158c8e1e33150c # v2
         with:
-          path: '.'
+          path: "."
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@9dbe3824824f8a1377b8e298bafde1a50ede43e5 # v2

.markdownlint.yaml

@@ -0,0 +1,6 @@
+default: true
+MD013: false
+no-hard-tabs: false
+whitespace: false
+MD024: false
+MD025: false

.markdownlintignore

@@ -0,0 +1 @@
+CODE_OF_CONDUCT.md

.pre-commit-config.yaml

@@ -0,0 +1,9 @@
+repos:
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.37.0
+    hooks:
+      - id: markdownlint-fix
+  - repo: https://github.com/google/yamlfmt
+    rev: v0.10.0
+    hooks:
+      - id: yamlfmt

README.md

@@ -1,7 +1,55 @@
-# DevPsyOps Website
+---
+title: DevPsyOps
+subtitle: Developer Psychological Operations
+description: "Unleash the Power of DevPsyOps: Crush Internal Politics and Boost Business Value! 🚀🧠 Learn how psychology transforms developers into business rockstars in the face of adversity. #DevPsyOps #BusinessSuccess"
+url: https://devpsyops.com
+repo: https://github.com/chrisns/devpsyops
+---
 
-Unleash the Power of DevPsyOps: Crush Internal Politics and Boost Business Value! 🚀🧠 Learn how psychology transforms developers into business rockstars in the face of adversity.
+::::: article
 
-Publishes to https://DevPsyOps.com
+## TL;DR: Dev<em>What</em>Now?
 
-I ❤️ Pull requests!
+[Psychological Operations (PSYOPS)](https://www.merriam-webster.com/dictionary/psyops) in a military context involve the use of psychological tactics to influence the attitudes, emotions, and behavior of a target audience in order to achieve military objectives. In this space, PSYOPS plays a
+crucial role by leveraging psychological principles to shape perceptions, alter behaviors, and impact decision-making among both enemy and friendly populations.
+
+Similarly, in the context of DevPsyOps, the incorporation of psychological insights into software development can also influence user behavior and decision-making. By understanding user motivations,
+preferences, and cognitive biases, developers can tailor user interfaces, features, and communication strategies to guide users toward desired actions, just as psychological tactics guide military targets toward specific behaviors. This user-centered approach can result in increased engagement, higher adoption rates, and more successful software products, mirroring the objectives of PSYOPS in the military domain.
+
+DevPsyOps, a combination of Development, Psychology, and Operations, can bring about a more holistic and effective approach to software development. By incorporating psychological insights into the
+development process, teams can better understand user behavior, enhance user experience, and optimize software performance. This can lead to increased user satisfaction, better retention rates, and improved overall product success. Moreover, DevPsyOps can foster healthier team dynamics and communication, resulting in higher developer satisfaction and productivity. This interdisciplinary approach can ultimately lead to more thoughtful, user-centric, and successful software products.
+
+:::::
+
+::::: article
+
+## How does this fit into the other DevOps practices, and why do we need another?
+
+DevPsyOps stands apart from other DevOps practices by emphasizing the integration of developers within the business context, particularly in situations involving internal political challenges.
+
+We need it because software development is a creative process, not an industrial one.
+Treating developers like unthinking cogs in a production pipeline to be told what to do creates a poor working environment for everyone and usually terrible outcomes. So they need to know how to work in the customer environment and the customer needs to know how to work with them.
+
+Here's how DevPsyOps differs from other practices:
+
+### DevPsyOps (Development, Psychology, Operations)
+
+- **Psychological Alignment**<br /> DevPsyOps focuses on understanding the psychological dynamics of interfacing developers with the rest of the business. It recognizes developers' motivations and concerns, tailoring strategies to promote collaboration and deliver business value amidst internal political adversity.
+- **Emotional Intelligence**<br /> DevPsyOps places importance on emotional intelligence and effective communication, aiming to navigate complex interpersonal relationships and conflicts.
+- **Internal Politics**<br /> DevPsyOps specifically addresses internal political challenges that might hinder effective collaboration and value delivery. It aims to create an environment where developers can thrive despite such challenges.
+
+### DevSecOps (Development, Security, Operations)
+
+- **Security Integration**<br /> DevSecOps primarily revolves around seamlessly integrating security
+  measures into the development and operational processes to ensure the safety of applications and data.
+- **Risk Management**<br /> DevSecOps focuses on identifying and mitigating security risks associated with software development and deployment.
+- **Compliance and Regulations**<br /> DevSecOps ensures that applications adhere to relevant security regulations and compliance standards.
+
+### DevFinOps (Development, Finance, Operations)
+
+- **Financial Optimization**<br />DevFinOps centers on optimizing costs and resource allocation within the software development lifecycle, ensuring efficient financial practices.
+- **Budget Management**<br />DevFinOps involves tracking and managing expenses related to development, operations, and infrastructure.
+- **Resource Efficiency**<br />DevFinOps focuses on minimizing wastage and maximizing resource utilization to align with budgetary constraints.
+
+In summary, DevPsyOps uniquely addresses the challenges of internal politics and psychological dynamics when integrating developers into the business context. It complements DevSecOps' focus on security integration and DevFinOps' emphasis on financial efficiency, each contributing distinct perspectives to the overall DevOps philosophy.
+:::::