Expectation

Go to webpage https://atlassianps.org/docs/Contributing/
and click on Homepage link under thank you quoted message

Status Quo

I am expecting to be redirected to https://atlassianps.org/#people, however the link is not working on chrome and edge browsers

My suggestion

$('a[href*="#"]:not([href="#"]), a.inpage-navigation[href*="#"]').on('click', function (event) { event.preventDefault(); smoothScroll($(this.hash)); });

change to
$('a[href^="#"]:not([href="#"]), a.inpage-navigation[href*="#"]').on('click', function (event) { event.preventDefault(); smoothScroll($(this.hash)); });

in the theme.js file, as I bet smooth scroll broke such URLs

git submodule foreach git pull origin master
git add modules/ConfluencePS
git commit -m "Update module ConfluencePS"
git push

Description

Each module should have it's own page using layout _layouts/module.html

Should this be about_ModuleName?
Should this be readme?

Description

There is a EU Regulation that requires homepages to "inform users that cookies are not being used to gather information unnecessarily"

Description

User should be able to get a slack invite from the homepage

Expectation

go to https://atlassianps.org/docs/Gallery/SQLServerUpdatesToJIRAIssues.html and scroll down to the bottom

Status Quo

There is an empty Code section without any code.
Also link to tsvenbla profile is 404

My suggestion

tsvenbla is not on github anymore, if you cannot find his code and host it elsewhere, I suggest remove that post and section.

this section is still missing

is blocked by #9

paypal.me/AtlassianPS

Description

Documentation pages should have their own layout

ToDo

• create _layouts/docs.html
  • should have own sidebar with scrollspy
  • should have additional nav bar to explore commands
  • should have a way to navigate in the docs across modules and common docs
  • should use about_ModuleName as index

Structure

Ideal structure

/docs
  /HowToContribute.md
  /BitbucketPS
    /about_BitbucketPS.md
    /Get-Branch.md
  /ConfluencePS
    /about_ConfluencePS.md
    /Get-Space.md

Is it possible to expose this structure by storing the submodules in _includes/?

Description

Have a way to register persistent data

Use Case

• Cache github data
• Register errors

ToDo

• register subdomain api
• serve a Laravel instance on subdomain
• create rest interface for cache
• create rest interface for error logging

• show the count of current open issues of repo
• link to issues overview instead of new issue

find all contributors and add them to _data/index/people.yml

Description

Module summary should contain the # of PSGallery downloads

• The right navigation of the docs , the toc, currently shows only h2 headers
  However, on the index of modules (about_*) the h1 tag would be more appropriate
• The TOC sidebar should allow ScrollSpy

It would be nice to have a header with some extra metadata visualized for an article.

Expectation

A bit like docs.microsoft.com

Where you can see the contributors and maybe even a "time to read" for articles/posts.

Status Quo

Now we don't have the contributors nor the "time to read"

My suggestion

Use a contributors yml field in the .md files like contributors: lipkau, tomasdeceuninck

frontpage still contains links that are not point to the correct location

Description

Contact page should include information on how the user can create issues or reach the organization

Currently the left navigation expands the ul of the module even when the user is in the root of docs

Description

Organization should be able to write posts

• homepage uses a mix of font-families : harmonize
• fix styling of buttons on landing page
• make logo a working link and make it navy blue

all pages need a footer