SemanticWeb-Schema/lib/SemanticWeb/Schema/Question.pm
use utf8;
package SemanticWeb::Schema::Question;
# ABSTRACT: A specific question - e
use v5.14;
use Moo;
extends qw/ SemanticWeb::Schema::Comment /;
use MooX::JSON_LD 'Question';
use Ref::Util qw/ is_plain_hashref /;
# RECOMMEND PREREQ: Ref::Util::XS
use namespace::autoclean;
our $VERSION = 'v23.0.0';
has accepted_answer => (
is => 'rw',
predicate => '_has_accepted_answer',
json_ld => 'acceptedAnswer',
);
has answer_count => (
is => 'rw',
predicate => '_has_answer_count',
json_ld => 'answerCount',
);
has edu_question_type => (
is => 'rw',
predicate => '_has_edu_question_type',
json_ld => 'eduQuestionType',
);
has parent_item => (
is => 'rw',
predicate => '_has_parent_item',
json_ld => 'parentItem',
);
has suggested_answer => (
is => 'rw',
predicate => '_has_suggested_answer',
json_ld => 'suggestedAnswer',
);
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
SemanticWeb::Schema::Question - A specific question - e
=head1 VERSION
version v23.0.0
=head1 DESCRIPTION
A specific question - e.g. from a user seeking answers online, or collected
in a Frequently Asked Questions (FAQ) document.
=head1 ATTRIBUTES
=head2 C<accepted_answer>
C<acceptedAnswer>
The answer(s) that has been accepted as best, typically on a
Question/Answer site. Sites vary in their selection mechanisms, e.g.
drawing on community opinion and/or the view of the Question author.
A accepted_answer should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::Answer']>
=item C<InstanceOf['SemanticWeb::Schema::ItemList']>
=back
=head2 C<_has_accepted_answer>
A predicate for the L</accepted_answer> attribute.
=head2 C<answer_count>
C<answerCount>
The number of answers this question has received.
A answer_count should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::Integer']>
=back
=head2 C<_has_answer_count>
A predicate for the L</answer_count> attribute.
=head2 C<edu_question_type>
C<eduQuestionType>
For questions that are part of learning resources (e.g. Quiz),
eduQuestionType indicates the format of question being given. Example:
"Multiple choice", "Open ended", "Flashcard".
A edu_question_type should be one of the following types:
=over
=item C<Str>
=back
=head2 C<_has_edu_question_type>
A predicate for the L</edu_question_type> attribute.
=head2 C<parent_item>
C<parentItem>
The parent of a question, answer or item in general. Typically used for Q/A discussion threads e.g. a chain of comments with the first comment being an L<SemanticWeb::Schema::Article> or other L<SemanticWeb::Schema::CreativeWork>. See also [[comment]] which points from something to a comment about it.
A parent_item should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::Comment']>
=item C<InstanceOf['SemanticWeb::Schema::CreativeWork']>
=back
=head2 C<_has_parent_item>
A predicate for the L</parent_item> attribute.
=head2 C<suggested_answer>
C<suggestedAnswer>
An answer (possibly one of several, possibly incorrect) to a Question, e.g.
on a Question/Answer site.
A suggested_answer should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::Answer']>
=item C<InstanceOf['SemanticWeb::Schema::ItemList']>
=back
=head2 C<_has_suggested_answer>
A predicate for the L</suggested_answer> attribute.
=head1 SEE ALSO
L<SemanticWeb::Schema::Comment>
=head1 SOURCE
The development version is on github at L<https://github.com/robrwo/SemanticWeb-Schema>
and may be cloned from L<git://github.com/robrwo/SemanticWeb-Schema.git>
=head1 BUGS
Please report any bugs or feature requests on the bugtracker website
L<https://github.com/robrwo/SemanticWeb-Schema/issues>
When submitting a bug or request, please include a test-file or a
patch to an existing test-file that illustrates the bug or desired
feature.
=head1 AUTHOR
Robert Rothenberg <rrwo@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is Copyright (c) 2018-2023 by Robert Rothenberg.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
=cut