Skip to content

Initial draft #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
May 1, 2022
Merged

Initial draft #1

merged 4 commits into from
May 1, 2022

Conversation

samdark
Copy link
Member

@samdark samdark commented Jan 13, 2022

  • Initial text is taken from PSR-12
  • Meta and intro were adjusted to mention PER
  • Some typos (commas mainly) were fixed

Do not merge before #2

which does not support long type aliases. Therefore, it makes sense to enforce primary short type forms to be used to
have uniform syntax and prevent possible confusion.

### 4.4. Public Survey
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would split this and other too-old-stuff coming from PSR-2 in a separate file... But maybe we can do it later, when we make changes to the PER.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a lot of stuff from the meta doc we can probably just toss out at this point, and I'd honestly like to see the spec part split into multiple pages for ease of reading/editing. That's all post-1.0 though.

@KorvinSzanto
Copy link
Contributor

I think it's important that we capture the current state of PSR-12 in an initial commit before we start modifying it so that we can track on those changes more easily. We should be able to get that merged in before merging this one and have everything work as expected.

@samdark
Copy link
Member Author

samdark commented Jan 14, 2022

@KorvinSzanto you mean pure PSR-12 text without any modifications?

@samdark samdark mentioned this pull request Jan 14, 2022
samdark and others added 2 commits January 14, 2022 22:50
Co-authored-by: Alessandro Lai <alessandro.lai85@gmail.com>
@KorvinSzanto
Copy link
Contributor

you mean pure PSR-12 text without any modifications?

Exactly, I am not too worried about the PSR / PER distinction but just for posterity sake I like the idea of every change being tracked. #2 is exactly what I was looking for, it should be able to merge prior to #1 merging without conflicts.

Copy link
Contributor

@KorvinSzanto KorvinSzanto left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is good to merge but we should make a couple additional changes prior to a vote to tag 1.0.0 as noted in my comments

* **Entrance Vote:** https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!msg/php-fig/P9atZLOcUBM/_jwkvlYKEAAJ
* **Approval Vote:** https://groups.google.com/forum/#!topic/php-fig/1uaeSMaDGbk
* **Entrance Vote:**
* **Approval Vote:**
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be updated with the PER approval vote


_**Note:** Order descending chronologically._

* [Inspiration Mailing List Thread](https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!topic/php-fig/wh9avopSR9k)
* [Initial Mailing List PSR Proposal Thread](https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!topic/php-fig/MkFacLdfGso)
*
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be good to include a link to PSR-12 here

@@ -8,24 +8,24 @@ interpreted as described in [RFC 2119][].

## Overview

This specification extends, expands and replaces [PSR-2][], the coding style guide and
This specification is a live document that extends, expands and replaces [PSR-12][], the extended coding style guide and
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In my opinion this document is not a living document. The latest commit is not the source of truth the CC approved tag is.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Makes sense. Will fix that.

* Robert Deutz
*
*
*
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably want to get this list shored up now that we have an official WG

@samdark
Copy link
Member Author

samdark commented Feb 2, 2022

@KorvinSzanto I thought the idea was to tag PSR-12 original as 1.0.0 without any changes / fixes.

@KorvinSzanto
Copy link
Contributor

KorvinSzanto commented Feb 2, 2022

That doesn't makes a whole lot of sense to me. I advocated for getting PSR-12 merged verbatim before this PR so that the git history would include all changes, I didn't mean to suggest that should also apply to the versioning. In my opinion a 1.0.0 should have proper metadata and not be labeled PSR-12.

We should discuss more in discord.

@KorvinSzanto KorvinSzanto merged commit a7cf51f into php-fig:master May 1, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants