WIP: Create initial template. #2

Draft
scott wants to merge 4 commits from repo-init into main
Owner
No description provided.
scott added 2 commits 2023-09-01 06:12:49 -04:00
scott force-pushed repo-init from 517503cec3 to a31d484949 2023-09-01 06:21:28 -04:00 Compare
First-time contributor

Ok I am of two mind sets with this...

A. For and initial getting started point, it gets you off the ground. Sure approve and move forward.

B. If this is a template to be used on project creation, all of this should go and it should be only template headers and not so instruction based

(I made this up on the fly with no thought)
README.md:

# PROJECT NAME
a description of the project

### Requirements
list what software is required to run the project

### Documentation
point to were one can find documentation, whether the wiki, or doc/ directory

## Getting setup
describe how to set up the project for local development
Ok I am of two mind sets with this... A. For and initial getting started point, it gets you off the ground. Sure approve and move forward. B. If this is a template to be used on project creation, all of this should go and it should be only template headers and not so instruction based (I made this up on the fly with no thought) README.md: ``` # PROJECT NAME a description of the project ### Requirements list what software is required to run the project ### Documentation point to were one can find documentation, whether the wiki, or doc/ directory ## Getting setup describe how to set up the project for local development ```
scott added 1 commit 2023-09-02 09:53:30 -04:00
scott changed title from Create initial template. to WIP: Create initial template. 2023-09-02 09:54:47 -04:00
Author
Owner

The more I try to work on this the more the whole thing feels like a futile effort, largely because in most cases the language tooling that we're working with will build out this sort of scaffolding for us in most cases. I was trying to combine the idea you had there with the README generated by crystal init, you can see what I have so far in the most recent commit. If we bother with keeping this repo around I'm going to squash the commits.

There is a possibility that variable substitution may work here, which would be nice, occasionally, but I think it may be a better idea to focus on documenting smaller tasks as we do them than to try to seed some vast wiki of documentation that won't be all that useful anyway.

The more I try to work on this the more the whole thing feels like a futile effort, largely because in most cases the language tooling that we're working with will build out this sort of scaffolding for us in most cases. I was trying to combine the idea you had there with the README generated by `crystal init`, you can see what I have so far in the most recent commit. If we bother with keeping this repo around I'm going to squash the commits. There is a possibility that [variable substitution](https://docs.gitea.com/usage/template-repositories) may work here, which would be nice, occasionally, but I think it may be a better idea to focus on documenting smaller tasks as we do them than to try to seed some vast wiki of documentation that won't be all that useful anyway.
This pull request is marked as a work in progress.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin repo-init:repo-init
git checkout repo-init

Merge

Merge the changes and update on Forgejo.
git checkout main
git merge --no-ff repo-init
git checkout main
git merge --ff-only repo-init
git checkout repo-init
git rebase main
git checkout main
git merge --no-ff repo-init
git checkout main
git merge --squash repo-init
git checkout main
git merge --ff-only repo-init
git checkout main
git merge repo-init
git push origin main
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: TWS/template#2
No description provided.