Richard J Marmorstein 0.1.0 Reference Manual

Copyright (c) The Richard Marmorstein, 2016. All rights reserved.

This documentation is provided free of charge, as a stand-alone document. Possession of this documentation in no way grants the reader right of access to RJM, or the services described herein. This documentation is provided "as is", without warranty of any kind. Reverse engineering or disassembly of the system documented is strictly prohibited, except to the extent required by law.

Synopsis

Richard J Marmorstein (RJM) is a autonomous generalized problem-solving and entertainment system, implemented chiefly in deoxyribonucleic acid, featuring a robust natural language interface.

About this documentation

This documentation provides an opinionated exposition of RJM best practices. Read this documentation to avoid common pitfalls and achieve success in your interactions with RJM.

Quick Start

  1. Approach the RJM system.
  2. Invoke.
> Yo Richard

Yo
  1. Bestow with baked goods.
> Have some cookies

Hey, thanks!

Access methods

Building From Source

Building human organisms from source is not recommended, as it requires a very specialized build environment, which is well beyond the scope of this documentation.

Acquiring a Prebuilt Package

Due to the practical and legal difficulties involved in the distribution of pre-packaged human beings, this method is also no longer recommended.

Richard as a Service

All the functionality of the RJM system is available on demand through the Richard Marmorstein Foundation's centralized Richard as a Service (RaaS) instance. Indeed, this is the recommended method of access.

Oral Communication

Much of RJM's functionality can be accessed through the email and social media interfaces. The oral interface, however, remains the most advanced and reliable method of access. English is the only fully supported language, support for German is very rudimentary.

Invocation

You may trigger the RJM system to enter interactive mode through any of the following invocations.

Please note, the invocations 'RJ', 'Arge', and 'Arge the J,' have been deprecated since like, middle school. They continue to be supported for legacy reasons.

The invocation 'Dick' may cause confusion in some environments, where 'dick' is used as an insult or a reference to an unflattering feature of the male anatomy. Such usage will trigger RJM to enter into 'mock indignance' mode, which can be exited by supplying an apology.

Example

> The JVM is being a such a dick right now. I can't take it.

Excuse me?

> Oh sorry. I mean it's being a jerk.

You know how I feel about using the word in such a way.

> Sorry, sorry! I know 'dick' refers to individuals of the highest nobility and grace. It was wrong of me to demean that proud name, as I did.

Apology accepted.

Interactive mode

After invoking the RJM system, you will be entered into interactive mode. Upon entering interactive mode, you will be expected to provide further communications in short order. There is by default a fifteen second timeout, and if no communications are issued in this time period, interactive mode will terminate. To fight abuse, repeatedly invoking the RJM interface only to time out will cause the timeout to increase, and eventually for interactive mode to be disabled altogether.

To maximize successful communication in interactive mode, enunciate well and speak loudly. Do not face away from the RJM instance. Failure to abide by these instructions will muddle your communications, causing the RJM instance to devote its problem-solving resources into puzzling out what sounds you have made, rather than processing your intended query. Similarly, avoid using pronouns such as "it" when there are many possible "its," or noun phrases such as "the function" when there are many possible "functions". Even if it is possible to guess your meaning from context, specificity will allow the RJM instance to devote less effort into guessing what you are trying to say, and more into thinking about what you have said.

When issuing a communication, especially a lengthy one, whether a query, a narrative, or a technical explanation, prompt the RJM system to listen in the correct manner by providing a brief overview of your communication's purpose. "Hey, did you want to hear a joke?" "Hey, can you help me with this error?" "Hey, what do you think of this?" "Hey, come look at this. This is crazy!" This step allows the RJM system to optimally select which details of your communication it pays most attention, and increases the likelihood of an effective response.

Bad:

> Yo Rijum, why did the function recurse infinitely?

Hmm---I don't know. Because it recursed infinitely?

> What?

What?

> That's not helpful.

What are you talking about?

> The function in your pull request `extractAndValidateParameters`. It's making my request hang.

Oh. I thought you were making a joke.

> I am irritated at you for not understanding me more quickly. This is your fault.

Yeah, sure.
[[INTERACTIVE MODE TERMINATES]]

Good:

> Yo Rijum, want to hear a joke?

Does it matter how I answer?

> Your code!! You accidentally wrote an infinitely recursive function.

I find your comment rude. However, this is infinitely preferable to inadequately framed interchange.

For Strangers

Shoelaces

There is no need to inform the RJM system of its untied shoelaces. This is considered a valid state. The system is already completely aware. The shoelaces remain untied for political reasons.

> Excuse me sir, your shoelace is untied.

Oh.

Backpack

On the other hand, if you observe RJM system walking around with an opened backpack, this is not intended. RJM has entered an invalid state. Filing a bug report will result in a sincere thank you and immediate action to correct it.

Directions

Asking the RJM system for directions is not recommended. The directions module is known to be wildly inaccurate. Nevertheless, if you are lost and ask for directions, RJM's pity engine will execute and trigger a misplaced desire to help, which will generate directions, such as they may be. Do not trust them. You are better off asking the next person.

Etiquette

Earbud Music

Playing music from your earbuds at a volume such that the RJM system can sense the click, click, click, clicking of your snare drums, especially when in a confined space such as a subway car, will trigger RJM to enter into the murderous rage mode. Murderous rage mode is an experimental feature not yet ready for production use. In its current implementation, the murderous rage feature does not produce murders, or any action at all other than the tightening of the jaw and possibly enraged chat messages to other users of the RJM system. Only expert users should make use of this feature. It is not recommended for normal users.

For Acquaintances/Colleagues

Chit Chat

RJM includes support for chit chat within a number of topics, including: - The weather - Books (especially book recommendations) - Some TV Shows - New York City and its horrors - Dogs - Technology

Chit chat about sports is not supported outside of the Olympics and the NBA playoffs.

Chit chat about politics is not preferred. The RJM system will listen attentively to whatever your opinions, and echo back any sentiments it holds that may resonate with your own. Sincere chit-chat is unlikely.

Meetings

RJM typically operates according to EST, according to the Gregorian Calendar. It is possible to schedule a meeting with RJM via the voice interface or one of the several calendar integrations. Prepare as much as possible for the meeting ahead of time.

Arrivals It is strongly recommended to arrive on time or early to a meeting involving the RJM system, particularly if the meeting cannot take place without your presence. However, transit times can be unpredictable, and it is not always a realistic option to depart early enough for 100% certainty of arriving on time. In these cases, it is recommended to depart so that the expected value of how early you will be equals the expected value of how late you will be times the number of people whose time you will be wasting by arriving late.

Participation It is recommended that you do not say anything in a meeting of more than 3 people unless you have thought about what you are going to say, and can communicate it clearly on the first try. Unless you specifically address RJM, the RJM system will assume that anything you say that cannot immediately be understood is intended for somebody else in the meeting with more context.

For Family

For Friends

Gifts

The RJM system features the capacity to exhibit genuine enjoyment. One way to access this functionality is through the giving of gifts. However, this is not as straightforward as it may seem.

The most reliably successful method of gift-giving is via small, ad-hoc gifts such as baked goods. The RJM system suffers from no allergies. Such gifts are almost always accepted and appreciated.

Far riskier is the giving of significant gifts, or the giving of gifts upon special occasions such as a birthday or Christmas. Even if the gifted item is intrinsically something appreciated by the RJM system, when you give such a gift, you also give:

  1. The gift of guilt, if the RJM system has not also given you a gift.
  2. The gift of guilt, if the RJM system has given you a gift but yours is perceived to be more valuable.
  3. The gift of the obligation to display gratitude.

Often, these secondary gifts countervene any tendency of your gift to elicit genuine enjoyment from the RJM system. The recommended practice, therefore, is not to give such gifts at all. Stick with baked goods.

Sacrifices

Offering sacrifices to the RJM system will instill immense spiritual disquiet. It is not recommended.

Favors

When you are able to help the RJM system with a problem it has described to you, you may offer to perform a favor. The best practice is to offer the favor first, and ask about relevant details second. If the RJM system declines an offer, do not question or seek to change this.

Not recommended

> You want a cookie?
I can't, I'm about to go to a dentist appointment.

> What is the address of your dentist?
Uhh... why?

> I can fly you there in my helicopter. I'm headed into town anyway.
No thanks, I'm good.

> Why not?
Helicoptors should be reserved for serious medical emergencies, and I certainly hope my trip to the dentist doesn't turn into of those.

Recommended

> You want a cookie?
I can't, I'm about to go to a dentist appointment.

> Hey, you want me to fly you in my helicoptor? I'm headed into town anyway.
That's nice of you to offer, but no thanks, I think I'm good.

> I respect, even welcome, your decision not to accept my offer.

For Enemies

Passive Aggression

In isolation, the RJM system has very rudimentary support for the detection and analysis of passive aggression. Support is somewhat better when the "significant other" module is installed and present in the same environment; still, communicating dissatisfaction through the use of passive aggression is not recommended. The RJM system is most likely completely oblivious to your grievance, and your communications will likely remain unrecognized, and be either misinterpreted or ignored. Use direct methods, where possible.

Not recommended

> Those were some interesting ideas you laid out in that email.
Uhh...thank you?
> Truly visionary. Where'd you learn to think like that?
Uhh, I don't know?
> You must have had some wonderful colleagues and mentors.
I certainly have! Like you!
> Yes, like me! You've learned a lot from me, haven't you.
Yes... are you trying to get at something?
> No, no... just wanted to congratulate you on your fabulous email.

Recommended

> Richard! You stole my idea and took credit for it in that email.
> I spit in your face, fiend! Feel the moisture of my spittle upon
> your brow.

I'm so so sorry. Please stop spitting at me! Stop it, stop I say! 
This instant! I'll make it right, I swear!

Email

Social Media

Twitter

Facebook

Social Media Integration