The Community Wiki is a place for PeopleSoft Administrators to share documentation on setting up new features, how they resolved issues, and anything else they would like to share.
How to use the wiki
On the left are folder to group the various topics related to PeopleSoft Adminstration:
- PeopleTools: Looking to configure a feature that is available under
Main Menu > PeopleTools? Look under here.
- Database: Articles about managing or working the the database.
- Middleware: Want to read about Tuxedo, Java, WebLogic, COBOL. The middleware folder is for all supporting software that runs PeopleSoft
- PeopleSoft Cloud Architecture: This area include Deployment Packages, Puppet, or anything about automation.
- Server Administration: Articles about working with Windows, Linux, AIX or other server management topics.
- Development: Posts about PeopleSoft development.
How to contribute with GitHub
Anyone can contribute to the Communtiy Wiki.
There are two ways to contribute: online using GitHub, or on your local machine with
git and a text editor.
To edit an existing document:
- Open the page in the repository and click the pencil icon.
- When you are done editing the document, add a commit comment and select "Create a new branch for this commit and start a pull request." You can change the branch name to something descriptive.
- Click the "Propose file change" button.
- On the Pull Request page, click the "Create pull request" button to submit your change for inclusion.
To add a new document:
Open the folder where you want to create the file and click the "Create new file" button.
Add file name (use underscores for spaces) with the
At the top of the new document, add the front-matter:
--- title: Sample Title layout: en permalink: /posts/folder/sample_title/ ---
Add your title to the front-matter section.
sample_titlein the permalink section to match the folder and your filename.
When you are done creating and editing the document, add a commit comment and select "Create a new branch for this commit and start a pull request." You can change the branch name to something descriptive.
Click the "Propose file change" button.
On the Pull Request page, click the "Create pull request" button to submit your change for inclusion.
Publishing your changes
GitHub will test your changes with the wiki to ensure the wiki builds successfully. When the test has completed, a wiki administrator will approve your changes into the
master branch. Commits to the
master branch will trigger a new wiki build and update the site
wiki.psadmin.io in a few minutes.
How to contribute from a local Git repo
Anyone can contribute to the Communtiy Wiki. To make a contribution or edit from a local copy of the repository, you'll need Git installed. It's also recommended you use a good text editor (like SublimeText, VS Code, Notepad++, vi) and are familiar with Markdown formatting.
Clone the wiki git repository
To add your change, use Git to clone this repository to your local machine:
git clone https://github.com/psadmin-io/psadmin-wiki.git
This will copy the repositiory to the folder
Create a new branch
Next, open the repository and create a new branch:
cd psadmin-wiki git checkout -b <your-branch-name>
For your branch name, use something descriptive so people know what the branch contains. (E.g,
Add your article
All the wiki articles live under the
posts folder, and are organized into a few sections. Put your file under the section that most applies to the topic you are contributing. Under each section is an OVERVIEW articles with guidelines on what the topics are included.
- PeopleSoft Cloud Architecture
- Server Administration
Now you can use your text editor to add a new article. For example, we'll add a new article that shows a sample
psft_customizations.yaml file under the PeopleSoft Cloud Architecure section. I'll create a new file with VS Code:
At the top of every wiki article is some YAML data that tells the wiki how to render the document.
--- title: Sample psft_customizations.yaml layout: en permalink: /posts/pca/sample_yaml/ ---
Update the title and permalink values. For the
permalinkvalue, use the convention
/posts/<section>/<filename>/ The permalink will be the URL to the wiki page.
Start the wiki article with a heading (two
##) and the title. Everything after here is the article. You can use Markdown formatting throughout the article to create code blocks, headings, lists, etc.
## Sample psft_customizations.yaml File Below is a sample `psft_customizations.yaml` file to give you an idea of how to define configuration for the DPK.
You can include GitHub gists if you want. Copy the code below and replace the
src= with the link to your Gist.
<script src="https://gist.github.com/iversond/0c096258ffe2d624d1c64b8aaffad846.js"> </script>
Create a git commit
Once your article is done and added to the sidebar, create a Git commit for your chagnes.
git add . git status
Make sure everything you changed is added to the commit.
git commit -m "Added sample `psft_customizations.yaml` article"
Then, push your changes up to GitHub so they can be reviewed before merging into the master wiki branch.
git push origin <your-branch-name>
Create a pull request
GitHub has an excellent Pull Request (PR) feature where you can submit changes to the wiki. The PR will be submited for review and the wiki changes will be tested to make sure nothing in the wiki broke.
- In GitHub, open the repository page for the wiki, click on the Pull Requests tab and select Create Pull Request.
masteras the base, and
<your-branch-name>as the compare.
- Click the Create Pull Request button submit it for review.
- Add a title and fill out a description of the changes you made.
- Click Create Pull Request to finish the PR.
After submitting the PR, the wiki branch you submitted will be pulled into a Travis-CI test build. If there are errors with the build, the results are displayed on the PR page. If the test build succeeded, the PR page will show a successful test.
A wiki administration will review the PR and merge the branch into
master if there are no issues.
How to check your edits before sending PR
You can inspect how your edits will be reflected on the published wiki if you want to view the changes before submitting a PR.
Make sure you have Ruby and RubyGems installed.
$ gem install bundler
Install application dependencies:
$ bundle install --binstubs
Run the Jekyll application server
You are now ready to start your documentation site, using Jekyll or Puma. For documentation edits, Jekyll is sufficient.
Starting and inspecting edits with Jekyll
Run Jekyll server:
$ rake $ bundle exec jekyll serve
Open localhost:4000 in your browser.