Skip to content
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

Some glossary terms have no description and others need to be moved around since they are not in alphabetical order #622

Closed
32 tasks done
AlexDaniel opened this issue Jun 22, 2016 · 8 comments
Labels
big Issue consisting of many subissues docs Documentation issue (primary issue type)

Comments

@AlexDaniel
Copy link
Member

AlexDaniel commented Jun 22, 2016

Things were added because they have to be explained in the glossary, but nobody bothered to write a proper description yet.

Since most of that stuff was moved from S99, perhaps it would make sense to delete some of the items. However, most of these terms actually need a description.

Please check items once they've been described or removed from the glossary. Team members can remove items from this list once they've been resolved.

  • bytecode
  • Callable
  • Code
  • Container
  • Cool
  • fiddly
  • handles
  • iffy
  • import
  • Lexing
  • List
  • machine code
  • Module
  • Multi-Dispatch
  • multi-method
  • opcode
  • OS
  • Parse Tree
  • Package
  • Perl Community
  • pugs
  • Regular Expression
  • Repository
  • Scalar
  • Sigilless Variable
  • Stub
  • Syntax Analysis
  • token
  • value
  • Variable Interpolation
  • whitespace
  • 6model
@AlexDaniel AlexDaniel added the docs Documentation issue (primary issue type) label Jun 22, 2016
@coke
Copy link
Collaborator

coke commented Jun 23, 2016

Anything that ties to a type (or some other docs that already exist) we can remove from the glossary list.

@Altai-man
Copy link
Member

Altai-man commented Jul 15, 2016

I filled some items with links, so probably they can be marked as done.
Also, if @coke message is still valid, it will be good to remove empty type/class/role entries I mentioned here: #582 (comment)
Is anyone against removing?

@AlexDaniel
Copy link
Member Author

@Altai-man I already have some progress on this. So no, definitely not against.

@Altai-man
Copy link
Member

I'll remove such entries tomorrow and update the table above then.

AlexDaniel added a commit that referenced this issue Jul 15, 2016
For example, remove stuff that is tied to a type (per discussion on #622)
@AlexDaniel AlexDaniel added the big Issue consisting of many subissues label Jul 15, 2016
@AlexDaniel
Copy link
Member Author

@Altai-man I already had it gathering dust (yay for git stash!). Pushed it a minute ago, so the situation is a bit better now. Feel free to finish it though.

Altai-man added a commit that referenced this issue Jul 15, 2016
…ass section.

This commit is a part of #622 resolving process.
Feel free to revert.
@Altai-man
Copy link
Member

I removed Hash with 75a689d, but it wasn't mentioned in the list above.
All other entries from the main list above need writing skills, so I can't help here.

@AlexDaniel AlexDaniel mentioned this issue Jul 20, 2016
99 tasks
@AlexDaniel
Copy link
Member Author

Closed in favor of #728. If #728 is rejected, then this issue should be reopened.

@JJ
Copy link
Contributor

JJ commented May 17, 2018

I'm reopening this, because there seem to be some terms here that were not in the #728.

@JJ JJ reopened this May 17, 2018
@JJ JJ changed the title Some glossary terms have no description Some glossary terms have no description and others need to be moved around since they are not in alphabetical order May 17, 2018
JJ added a commit that referenced this issue May 17, 2018
JJ added a commit that referenced this issue May 17, 2018
JJ added a commit that referenced this issue May 17, 2018
@JJ JJ closed this as completed in 9acacc8 May 17, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
big Issue consisting of many subissues docs Documentation issue (primary issue type)
Projects
None yet
Development

No branches or pull requests

4 participants